Macro Expert Manual

Download as pdf or txt
Download as pdf or txt
You are on page 1of 218

Table of Contents

Introduction ................................................................................................................................................................................................ 1 Compare Editions ................................................................................................................................................................................. 3 Installation and Uninstall ................................................................................................................................................................ 4 Minimum system requirements .................................................................................................................................................... 4 Installnation ........................................................................................................................................................................................... 5 Uninstalling ............................................................................................................................................................................................ 6 Work environment ................................................................................................................................................................................ 7 Getting familiar with Macro Manager ......................................................................................................................................... 7 Folder panel ....................................................................................................................................................................................... 10 The tool bar of the macro list ...................................................................................................................................................... 11 Working with the progress window ........................................................................................................................................... 12 Working with Macro Player Manager ...................................................................................................................................... 13 Using Macro Expert ......................................................................................................................................................................... 14 Basic concept of Macro Expert .................................................................................................................................................. 14 Creating a new macro ................................................................................................................................................................... 16 Playing a macro manually ........................................................................................................................................................... 18 Recording/Editing TemporaryMacro ........................................................................................................................................ 20 Playing TemporaryMacro ............................................................................................................................................................. 21 Stop Macro Service ........................................................................................................................................................................ 22 Disabling all triggers of macro ................................................................................................................................................... 23 Changing the properties of a macro .................................................................................................................................. 24 General ................................................................................................................................................................................................ 24 Scope .................................................................................................................................................................................................... 25 Triggers ................................................................................................................................................................................................ 26 Schedule .............................................................................................................................................................................................. 27 Play back ............................................................................................................................................................................................. 28 Advance ............................................................................................................................................................................................... 29 Triggering macro ................................................................................................................................................................................ 31 Triggering macro overview .......................................................................................................................................................... 31 Idle trigger ........................................................................................................................................................................................... 32 Startup trigger ................................................................................................................................................................................... 33 System event trigger ...................................................................................................................................................................... 34 Resource event trigger .................................................................................................................................................................. 35 Driver trigger ...................................................................................................................................................................................... 36 Dial trigger .......................................................................................................................................................................................... 37 Hotkey .................................................................................................................................................................................................. 38 Window Trigger ................................................................................................................................................................................ 39 File Trigger ......................................................................................................................................................................................... 40 Scheduling macro ............................................................................................................................................................................. 41 Scheduling macro overview ........................................................................................................................................................ 41 Minute ................................................................................................................................................................................................... 42 Daily ...................................................................................................................................................................................................... 43 Weekly ................................................................................................................................................................................................. 44 Monthly ................................................................................................................................................................................................. 45 Once ...................................................................................................................................................................................................... 46 At a time .............................................................................................................................................................................................. 47 Changing Options ............................................................................................................................................................................. 48 General ................................................................................................................................................................................................ 48 Hot keys ............................................................................................................................................................................................... 49 TemporaryMacro .............................................................................................................................................................................. 50

Play back ............................................................................................................................................................................................. 51 Record .................................................................................................................................................................................................. 52 Macro list ............................................................................................................................................................................................. 53 Auto-logon .......................................................................................................................................................................................... 54 Appearance ........................................................................................................................................................................................ 55

Script Editor

........................................................................................................................................................................................... Looking at the work area .............................................................................................................................................................. Inserting an action ........................................................................................................................................................................... Editing an action .............................................................................................................................................................................. Removing one or more actions ................................................................................................................................................. Working with the variables .......................................................................................................................................................... Macro Commands ............................................................................................................................................................................. General settings and Error Handling Options ..................................................................................................................... Keyboard and mouse ..................................................................................................................................................................... Key action ....................................................................................................................................................................................

56 56 57 58 59 60 61 61 62 62 Mouse action ............................................................................................................................................................................... 63 Put a Text ..................................................................................................................................................................................... 64 Mouse Move Activity .................................................................................................................................................................. 65 Mouse Action on Object ........................................................................................................................................................... 66 Series Keystrokes ...................................................................................................................................................................... 67 Dialog .................................................................................................................................................................................................... 68 Display Message Dialog ........................................................................................................................................................... 68 Select a Folder ............................................................................................................................................................................ 69 File-selection Dialog .................................................................................................................................................................. 70 Input Dialog ................................................................................................................................................................................. 71 Show Tip Text .............................................................................................................................................................................. 72 Hide tip text .................................................................................................................................................................................. 73 Choice Dialog .............................................................................................................................................................................. 74 Window ................................................................................................................................................................................................ 75 Window action ............................................................................................................................................................................ 75 Wait ....................................................................................................................................................................................................... 76 Delay ............................................................................................................................................................................................. 76 Wait for a window ...................................................................................................................................................................... 77 Wait for color ............................................................................................................................................................................... 78 Wait for keystroke ...................................................................................................................................................................... 79 Wait for mouse motion ............................................................................................................................................................. 80 Wait for file .................................................................................................................................................................................. 81 Wait for process ......................................................................................................................................................................... 82 Play Control ....................................................................................................................................................................................... 83 On Error ........................................................................................................................................................................................ 83 Pause ............................................................................................................................................................................................ 84 Stop ............................................................................................................................................................................................... 84 End ................................................................................................................................................................................................ 84 Play speed ................................................................................................................................................................................... 84 Play a macro ............................................................................................................................................................................... 85 Set emulation level .................................................................................................................................................................... 86 Block/unblock mouse and keyboard ..................................................................................................................................... 87 Log a Playback Message ......................................................................................................................................................... 88 Variable ................................................................................................................................................................................................ 89 Increase/Decrease value .......................................................................................................................................................... 89 Set value ...................................................................................................................................................................................... 90 Advanced Set Variable Value .................................................................................................................................................. 91 Advanced Get Variable Value ................................................................................................................................................. 93 Redefine Variable ....................................................................................................................................................................... 94

95 Convert Text ................................................................................................................................................................................. 95 Pad Text ........................................................................................................................................................................................ 96 Split Text ....................................................................................................................................................................................... 97 Trim Text ....................................................................................................................................................................................... 98 Find Text ....................................................................................................................................................................................... 99 Replace Text ............................................................................................................................................................................. 100 Fomat Datetime ....................................................................................................................................................................... 101 Flow .................................................................................................................................................................................................... 102 Comments ................................................................................................................................................................................ 102 Separator line ........................................................................................................................................................................... 103 Label ........................................................................................................................................................................................... 104 Goto ............................................................................................................................................................................................ 105 If variable .................................................................................................................................................................................. 106 If color ........................................................................................................................................................................................ 108 If File Exists .............................................................................................................................................................................. 109 If Window Exists ...................................................................................................................................................................... 110 Select Case ............................................................................................................................................................................... 111 Loop .................................................................................................................................................................................................... 112 Loop ............................................................................................................................................................................................ 112 Loop Windows ......................................................................................................................................................................... 113 Loop Files .................................................................................................................................................................................. 114 Loop Processes ....................................................................................................................................................................... 115 Loop Control ............................................................................................................................................................................. 116 System ............................................................................................................................................................................................... 117 Run .............................................................................................................................................................................................. 117 End Process ............................................................................................................................................................................. 118 Image search ............................................................................................................................................................................ 119 Text earch based on image .................................................................................................................................................. 120 Get Pixel from Point ............................................................................................................................................................... 121 Registry Operation .................................................................................................................................................................. 122 Call an External DLL .............................................................................................................................................................. 123 Send Message to Window .................................................................................................................................................... 124 Get Text from Object .............................................................................................................................................................. 125 Get Text from Point ................................................................................................................................................................. 126 Generate Random Number .................................................................................................................................................. 127 Carry out Action on Object ................................................................................................................................................... 128 Session ............................................................................................................................................................................................. 129 Log off ........................................................................................................................................................................................ 129 Start Screen-Saver ................................................................................................................................................................. 130 Lock workstation ..................................................................................................................................................................... 129 Shut down computer .............................................................................................................................................................. 131 Turn off/on Display ................................................................................................................................................................. 132 Clipboard .......................................................................................................................................................................................... 133 Copy, Cut, Paste and Clear .................................................................................................................................................. 133 Put a text to the clipboard ..................................................................................................................................................... 134 Get the text from the clipboard ............................................................................................................................................ 135 Multimedia ....................................................................................................................................................................................... 136 Play an audio ........................................................................................................................................................................... 136 Increase/Decrease Volume ................................................................................................................................................... 137 Adjust volume .......................................................................................................................................................................... 138 Sound Switch ........................................................................................................................................................................... 139 Sound on/off ............................................................................................................................................................................. 140 CD Player .................................................................................................................................................................................. 141
Text ........................................................................................................................................................................................................

142 On Popup Window on Webpage ........................................................................................................................................ 142 Open a Web page ................................................................................................................................................................... 143 Connect a Opened Webpage ............................................................................................................................................... 144 Close Webpage ....................................................................................................................................................................... 145 Read Field ................................................................................................................................................................................. 146 Fill Field ..................................................................................................................................................................................... 147 Click Element ........................................................................................................................................................................... 148 Find Element ............................................................................................................................................................................ 149 Submit Form ............................................................................................................................................................................ 151 Save webpage content .......................................................................................................................................................... 152 Save Image Element .............................................................................................................................................................. 153 Internet Explorer Navigation Actions .................................................................................................................................. 154 Internet .............................................................................................................................................................................................. 155 Send Email ............................................................................................................................................................................... 155 HTTP Download ...................................................................................................................................................................... 156 Ping ............................................................................................................................................................................................ 157 Retrieve Internet Time ........................................................................................................................................................... 158 Delete Tempoary Internet Files ............................................................................................................................................ 159 Delete Internet Explorer Cookies ........................................................................................................................................ 159 Clear Internet Explorer History ............................................................................................................................................ 159 Network ............................................................................................................................................................................................. 160 Make remote access connection ......................................................................................................................................... 160 Disconnect remote access connection .............................................................................................................................. 161 Connect network resource .................................................................................................................................................... 162 Disonnect network resource ................................................................................................................................................. 163 File ...................................................................................................................................................................................................... 164 Copy files .................................................................................................................................................................................. 164 Move files .................................................................................................................................................................................. 166 Delete files ................................................................................................................................................................................ 168 Create a folder ......................................................................................................................................................................... 169 Delete a folder .......................................................................................................................................................................... 170 Rename files ............................................................................................................................................................................ 171 Set file attributes ..................................................................................................................................................................... 174 Change file time ...................................................................................................................................................................... 176 Synchronize Folders ............................................................................................................................................................... 178 Compress files ......................................................................................................................................................................... 180 Extract a zipped file ................................................................................................................................................................ 182 Read text file ............................................................................................................................................................................ 183 Write text file ............................................................................................................................................................................ 184 Replace in File ......................................................................................................................................................................... 185 Document ......................................................................................................................................................................................... 186 Open Document ...................................................................................................................................................................... 186 Close Document ...................................................................................................................................................................... 187 Save Document ....................................................................................................................................................................... 188 Read Microsoft Excel Cell ..................................................................................................................................................... 189 Write Microsoft Excel Cell ..................................................................................................................................................... 190 Find Microsoft Excel Cell ..................................................................................................................................................... 191 Add Microsoft Excel Worksheet .......................................................................................................................................... 192 Remove Microsoft Excel Worksheet .................................................................................................................................. 193 Activate Microsoft Excel Worksheet ................................................................................................................................... 194 Wait for Microsoft Excel Cell ................................................................................................................................................ 195 Database .......................................................................................................................................................................................... 196 Connect to Data Source ........................................................................................................................................................ 196
Webpage ..........................................................................................................................................................................................

Close Data Source Connection ........................................................................................................................................... 197 Transaction on Data Source ................................................................................................................................................ 198 Execute SQL Statement ........................................................................................................................................................ 199 Connect Dataset In Parent ................................................................................................................................................... 200 Close Dataset .......................................................................................................................................................................... 201 Set Field Value ......................................................................................................................................................................... 202 Get Field Value ........................................................................................................................................................................ 203 Change Current Record Position ........................................................................................................................................ 204

Command Line Usage ................................................................................................................................................................ 205 Variables and Expressions ..................................................................................................................................................... 206 Frequent Question and Answer .......................................................................................................................................... 209 Purchasing Macro Expert ......................................................................................................................................................... 211 Contact Grass Software ............................................................................................................................................................ 212 License Agreement ....................................................................................................................................................................... 213

Help for Macro Expert

Introduction

Introduction Welcome to Macro Expert. Macro Expert is a powerful utility that is designed for automating the plodding and repetitive tasks. It will greatly simplify your work, increase your productivity, and free your time for other important jobs. W ith a tight integration scheduler, all of macros can be launched at specific time. All of macros even can be launched when some events occur, such as disk free space is low, a removable driver is arrived. Both of the ways give you an ability to do some unattended tasks. Ease of use Macro Expert is intuitive and a breeze to use. Tool buttons are used for all of functions because it is handy and clear to most users. Initial trainning and orientation time is reduced, allowing users to focus on producing results rather than learning how to use. No programming skills required! Variety of methods for playing macro Macro Expert supports a variety of methods for playing the macro, Hot-key combination, trigger, scheduler, and Systray menu. There is alway the one that is the most convenient for the circumstance. Scheduler Every managed macro can be scheduled to play back, you can schedule a macro to run at specific time that it is the most convenient for you, the frequency can be minute, daily, weekly, monthly, at a specific time or even random time. T rigger By Macro Expert Service, every managed macro can be triggered. It means every triggered macro will be launched when some events occur, such as disk free space is low, a removable driver is removed and much more. Hot key Every managed macro can be assigned to a hot key, when the key sequence is pressed, Macro Expert will launch the macro. Sometimes it is the most convenient way to complete a task. T emporaryMacro In Macro Expert, macros have two kinds, named macros and TemporaryMacro. The named macros enable you to name, describe, and add a password to protect the actions you record. A named macro can be scheduled and triggered. The TemporaryMacro enables you to quickly capture your mouse and keyboard input without having to name a macro, provide a description for it. Password protected You are able to add a password to a named macro. It should help you prevent unauthorized access to your macro as the password which will be required to open the macro. Scope of recording In general, recording a macro will capture(record) all mouse actions and keystrokes, but in some case, perhaps you'd like to record either keystrokes or mouse actions, we provide options to do so in Macro Expert.

[email protected]

1 / 213

Help for Macro Expert


Interface colorable

Introduction

Different users - different preferences. For this reason, Macro Expert offers a feature that allows you to adjust the hue and saturation of the appearance to accommodate your favor.

[email protected]

2 / 213

Help for Macro Expert


Compare Editions Feature T rigger System Trigger Startup Trigger Resource Trigger Driver Trigger Dial Trigger Actions Excel Document Operation Database Operation Keyboard/Mouse Play control System Variables Dialog Wait Flow Loop W indow Clipboard Multi-media Internet File Standard Edition

Compare Editions

Enterprise Edition

[email protected]

3 / 213

Help for Macro Expert

Minimum system requirements

Minimum system requirements To use Macro Expert properly, your system should meet or exceed the minimum system requirements below: Hardware Pentium 150Mhz or equivalent. 32MB or more of RAM. 6MB or more of free hard drive space. 65,000-color video display card. Software W indows NT 4.0 with Service Pack 4, 2000, XP, 2003, Vista *All other brands and names are property of their respective owners.

[email protected]

4 / 213

Help for Macro Expert

Installnation

Installation 1. Getting a copy of Macro Expert Macro Expert is a shareware (try-before-you-buy), You may get a copy via the following ways: 1. Visit to our download page, http://www.macro-expert.com/download.htm. 2. Search for a web pages that could download Macro Expert using The Search Engine such as Google, Yahoo and etc.. 3. Get it from your friends. 2. Installation The package file of Macro Expert is an executable file, to install it into your computer, just simply launch it to start out the setup progress. You will be prompted with a few questions during the setup progress, such as which components need to install, where you wish the product install to, and so on. After the progress, the program will copy all necessary files into your computer and create shortcuts to the Start-menu. In this section , if you want to create a desktop shortcut, you may check "Create a Desktop icon". If you are not familiar with the process of the installation, just simply click " Next" button on every setup page. As a result that Macro Expert will be installed with default options.

[email protected]

5 / 213

Help for Macro Expert

Uninstalling

Uninstalling T o remove this program from your computer: 1. Clicks on the Start-button and point to Programs. 2. Browses to Macro Expert folder. 3. Clicks the item Uninstall Macro Expert to uninstall.

Another way: 1. Opens the W indows Control Panel. 2. Double-clicks the Add/Remove icon. 3. Locates the item Macro Expert in the list and select it. 4. Clicks the Uninstall button.

[email protected]

6 / 213

Help for Macro Expert


Getting familiar with Macro Manager

Getting familiar with Macro Manager

The Macro Manager is a tool for administering macros, and controlling Macro Service. You utilize it to do the following: Creating a new macro Importing an existing script file as a managed macro Adding or removing the triggers from a macro Scheduling a macro Adding or removing a Systray menu item Changing the properties of a macro Setting the global system options Suspending/resuming Macro Service The work area of Macro Manager is activated when Macro Manager is started. The work area consists of the Menu bar, the Folder Panel, the Macro list tab, the Status panel and a systray icon.

Systray Icon Two systray icons will be placed when Macro Manager starts, you can click the manager icon to open the main window of Macro Manager if the window is invisible; you can also right-click the icon to popup a menu to access the common functions of Macro Manager. Another icon is for popuping a menu to play the macro, you could maintain the menu items on the folder panel Systray menu.

[email protected]

7 / 213

Help for Macro Expert

Getting familiar with Macro Manager

Folder Panel The Folder Panel is on the left of the main screen, it provides you with a access for browsing the macro list, hotkeys list, scheduled and triggered macro list. Macro list The Macro list consists of a tool bar and a grid which lists all of the managed macros. You are convenient to manipulate macros in the list, such as playing a macro, removing a macro, changing the properties of a macro, etc. Right-click on the selected macro, a context menu will popup for the most common action on the selected macro.

Status window The status window is placed for displaying the logs and a macro's summary, you use it to learn the current state of the macro manager and macro service, the actions to a macro, all of the properties on a macro and etc.

[email protected]

8 / 213

Help for Macro Expert

Getting familiar with Macro Manager

Manager log The panel will show all the logs from Macro Manager, the log contains events logged by Macro Manager. For example, a log record will be added when you suspend or resume the Macro Service, Macro Manager also record a message in the log when you play a macro. Note: You might turn the manager logging off, for more information, please see General Options. Service log The panel will show the logs about Macro Service, the service log contains all the communication message between the service with other programs, and the records indicate a macro to be launched by scheduler or trigger. Playback log Playback log contains the message during the macro playback, such as when the macro was launched, what actions were performed, and the error and warning occurred during playback. Note: If a macro has been configured to play without logging, the playback log will be empty. For more information about this, please see Advance Property Summary Show all of the properties about the selected macro, such as name, description, hot-key, last play and so on. That is more intuitive to the grid.

[email protected]

9 / 213

Help for Macro Expert


Folder Panel

Folder panel

The folder panel allows you to browse all macro under the data path, all used hotkeys, all scheduled and triggered macro. Click here to show the figure

Macro Explorer Under the panel, you may: Creating a folder Removing a folder Renaming a folder Creating a macro Removing a macro Hotkeys Under the panel, you may: Adding a macro for a hotkey Reassigning a macro to a hotkey Removing a hotkeyed macro Schedulers Under the panel, you may: Adding a macro for a scheduler Reassigning a macro to a scheduler Removing a scheduled macro T riggers Triggers are events that cause a macro to playback. Under the panel, you may view all available triggers. Adding a macro for a trigger Reassigning a macro to a trigger Removing a triggered macro Systray Menu Under the panel, you may: Adding a menu item. Editing a menu item. Removing a menu item.

[email protected]

10 / 213

Help for Macro Expert


T he tool bar of the macro list

The tool bar of the macro list

The tool bar provides a quick access to Macro Expert's common features which are used to manipulate the macros. Plays the selected macro, it will open a dialog to prompt you determining some parameters for playing. Plays the selected macro quickly, it is different from the Play, this will play the macro using the predetermined parameters without opening the play option dialog before playing. Loads the data of macro into the script editor for editing. Rerecord the selected macro, the original scripts will be overwritten with the new content when you finish the recording. Open a dialog for changing macro's properties. Views the playing log of the macro. Deletes the macro if it is no longer needed. Disables the selected trigger, macro or menu item. A disabled macro will not be launched (replayed) automatically by trigger, scheduler and hotkey. A disabled menu item will not be appeared in the systray menu. Enables the disabled macro, trigger or menu item.

[email protected]

11 / 213

Help for Macro Expert


Working with the progress window

Working with the progress window

The progress window is a dialog box that enables you to stop, pause and resume the process during playing or recording. In the period of playing, it also displays a progress bar to show you what the current position is in the actions of the macro. The image below shows you what the progress window looks like.

[email protected]

12 / 213

Help for Macro Expert


Working with Macro Player Manager

Working with Macro Player Manager

The Macro Player Manager gives you an access to control the running macros. You can pause, resume and stop any of running macros via it. To show Macro Player Manager: Clicks on the icon "Macro Manager" on the systray, and selects the item "show all running macros"

The image below shows you what Macro Player Manager looks like.

[email protected]

13 / 213

Help for Macro Expert

Basic concept of Macro Expert

Basic concept If you are new to Macro Expert, you need to learn some basic concepts, it is helpful to use Macro Expert. Macro Expert Macro Expert is a collection of several separate applications, all working together to act like one cohesive unit. These applications are the Macro Manager, the Macro Service, the Macro Script Editor and the Macro Player. Macro Service is responsible for administering the macro list, watching for conditions that would cause a triggered or scheduled macro to play. It also monitors the hotkey of macro. If Macro Service stopped, the trigger, scheduler and hotkey will be not available.

Macro Manager is a tool for administering the macro list, such as creating a new macro, importing an existing macro, removing a macro from the list, setting the global options, changing the property of a macro and much more.

Macro Script Editor is a tool for editing macro actions. Although a macro can be created by recording, but the recording only captures the mouse and the keyboard activities. You should use Macro Script Editor to get other useful actions, such as waiting for a window focused, displaying a message box of notice, copying or moving files.

Macro Player is player for playing the macro, it will be invoked by the Macro Service or Macro Manager.

What is macro? A set of keystrokes, mouse actions and instructions that are recorded, saved, edited. The recorded keystrokes, mouse actions and instructions can be played back (executed) in further. Macros can simplify day-to-day operations, which otherwise become tedious. For example, a single macro keystroke can open many websites at once, enter your name and address with pressing a hot key. T rigger The condition that causes a macro to playback. This can be based on a time and date or a system event( such as there isn't enough space for the disk, time is changed, or many other criteria). Named macro The named macros enable you to name, describe, and add a password to protect the actions. It can also be assigned to a hot key. In addition, every named macro can be scheduled or triggered. T emporaryMacro The TemporaryMacro enables you to quickly record your actions without having to name a macro, providing a description for it, or reviewing the resulting macro file. This also saves you some keystrokes whenever you want to run the TemporaryMacro, as it remains available until you record TemporaryMacro again.

[email protected]

14 / 213

Help for Macro Expert


Variable

Basic concept of Macro Expert

A symbol can hold different values at different times. For example, running the macro, the variable value might hold the number 10, after some actions executing, it might hold the string "ABC" or other value. Array An array is a collection that holds a fixed number of variables. These variables have the same name. Each variable in an array is called an element, and each element is accessed by its numerical index. The numerical index is also called subscript, and it begins with the number 0. The index number (subscript) must be surrounded by square brackets. For example : v_name[1], v_name[2] Expression It is a series of value elements combined with operators, which yields a new value. The operators act on the value elements by performing calculations, comparisons, or other operations. Unattended playback Automatical playback, that is playing a macro without pressing the hotkey or clicking the toolbar button to start. A macro can be scheduled or trigerred to automatically playback. Scope for playing Playing a named macro can be restricted under a condition that if a specified window exists. If you do not specify this condition, the macro is allowed to play in all windows. Note: For more information about the variable and expression, please click here.

[email protected]

15 / 213

Help for Macro Expert


Create a new macro T o create a macro by recording keyboard and mouse activities:

Creating a new macro

1. Under the menu "Script", select the item "New Macro Wizard" to launch the wizard for a new macro. 2. If recording is selected, the parameters dialog will appear to ask you to set options for recording. 3. Click OK to start recording. 4. W hen the recording starts out, you can perform the activities or tasks that you want to script. During the recording process, Macro Expert will track keyboard events and mouse events, and then turn these actions into Macro Expert steps. 5. Either pressing the hot key of Stop or clicking the Stop button on the progress window to abort the capture process and save the actions. T o create a blank macro 1. Under the menu "Script", select the item "Create Blank Macro". 2. On the "Properties", specify the name of the macro, hot-key for playback, and other properties. 3. Click OK to place the macro into the macro list. 4. Right-click the macro, and select the item "Edit" to launch Macro Script Editor for adding the actions. Dialog of recording options: Click here to show the figure

Macro name The name will appear in the macro list, it should be short but descriptive so you can quickly know what the macro does. Description Description for the macro. Hot key for playback Assign a hotkey to the macro, it is a convenient way to run the macro. Put the cursor into the field, and press the combination of the hotkey to retrieve the key. Repeat playback times Specifies how many times the macro should be played when the key combination is pressed. Clear hotkey Clear the hot key. Record keystrokes All the keystroke will be tracked and translated into Macro Expert actions, but the delay between two keystrokes will not be recorded. Save time interval between two keystokes Record the delay of between two keystroke sequences. Record mouse actions All the mouse actions except movements will be tracked and recorded. Record mouse movements

[email protected]

16 / 213

Help for Macro Expert


Capture the mouse movements and store them.

Creating a new macro

Start recording immediately after clicking OK button. Start the recording process at once, otherwise you should resume the process manually. Show/Hide options Show or hide the options, hiding options gives you a compact interface. Notes: If you have selected "Fill properties after finished recording." check box in the Record tab under the Options dialog, the new macro dialog will open after you finished recording. In this case, the last recording parameters will be used.

[email protected]

17 / 213

Help for Macro Expert


Playing a macro manually

Playing a macro manually

There are two ways to play a macro manually, regular playing and quick playing. The quick playing differs from the regular playing slightly, which does not open a play dialog box for asking playback options. About to play a macro automatically, please see the following: Scheduling a macro Triggering a macro T o play a macro regularly: 1. 2. 3. 4. Click on the Macro Explorer tab. Select the macro which you'd like to play. Click the tool button Play, the play dialog will popup. After determine the options for playing, click the OK to start playing.

T o quick play a macro: 1. Click on the Macro Explorer tab. 2. Select the macro which you'd like to play. 3. Click the tool button Quick Play, the playing process will be started immediately. T he play dialog: Click here to show the figure

Password Enter the access password if the macro is password protected. Repeat playback times How many times you'd like to play, the number zero does mean to continuously replay. Initial speed Click on the slider indicator, hold the mouse button down and move it to adjust the initial speed level of playback. Repeat Replay the macro continuously until you stop it. Pause after clicking the OK button W ith the option checked, after you click OK, the playing progress will be suspended until you resume it. Emulation level Specifies the emulation level of the mouse and keyboard acvitity. The hardware level emulation will bypass the protection of the most of games. Show progress window Specifies the progress window whether to show during playback. Dodge mouse pointer Specifies whether automatically dodge mouse pointer, if so, when the mouse pointer move over the progress window, the progress window will move to dodge the mouse pointer. You may take the option to ensure the mouse click action to perform correctly on the right window, otherwise, the progress window may be clicked unexpectedly. Initial variable value

[email protected]

18 / 213

Help for Macro Expert

Playing a macro manually

Specifies the initial value to the variables. Multiple variables may be specified by separating entries with the character &. If you specify multiple values to a variable, the last value will be used, for example: v_var1=123&v_var1=567&v_var1=88, the value of the variable v_var1 will be 88. Notes: "Repeat" does not take effect if the macro contains an instruction "End". "Speed" also be set by the instruction "Adjust Speed" in the script.

[email protected]

19 / 213

Help for Macro Expert


Recording/Editing T emporaryMacro

Recording/Editing TemporaryMacro

The TemporaryMacro allows you to quickly record keyboard and mouse activities without having to name a macro and providing a description to it. The actions of the TemporaryMacro will remain available until you record TemporaryMacro again. T o Record T emporaryMacro: Under the menu "T emporaryMacro", select the item "Record T emporaryMacro". . T o Edit T emporaryMacro: Under the menu "T emporaryMacro", select the item "Edit T emporaryMacro". You always edit the TemporaryMacro even if it's not been recorded. . Notes: Pressing the hotkey is a best way to record TemporaryMacro, this method is more convenient than using the menu. The hotkey for recording TemporaryMacro can be customized on the "Hotkey" tab under the "Change Settings". You can change the options of recording TemporaryMacro on the "T emporaryMacro" tab under the "Change Settings".

[email protected]

20 / 213

Help for Macro Expert


Playing T emporaryMacro T o play T emporaryMacro:

Playing TemporaryMacro

Under the menu "T emporaryMacro", click "Play T emporaryMacro " to start playing. Notes: Pressing the hotkey is a best way to play TemporaryMacro, this method is more convenient than using the menu. To change the hotkey, switch to the tab "Hotkey" under the dialog "Options". You can change the parameters of playing TemporaryMacro through the "T emporaryMacro" tab under the "Change Settings".

[email protected]

21 / 213

Help for Macro Expert


Stopping or start Macro Service

Stop Macro Service

You may suspend Macro Service. Macro Service is responsible for listening the hotkey, monitoring the events for the triggered macros. Stopping it will cause all of macros not to be launched automatically. T o suspend: Under the menu "File", selects the item "Stop Macro Service". T o resume: Under the menu "File", selects the item "Start Macro Service". Notes: You can Stop the Macro Expert by pressing a hotkey combination. About how to set the hotkeys, please refer to Hotkey Settings.

[email protected]

22 / 213

Help for Macro Expert


Disabling/Enabling all triggers of macro T o disable or enable all triggers of the macro: 1. Click on the Macro Explorer tab. 2. Select the macro you want to disable. 3. Click the tool button Disable/Enable triggers.

Disabling all triggers of macro

[email protected]

23 / 213

Help for Macro Expert


Changing the general properties Every named macro has many properties, such as name, description, related hotkey, etc. T o change the properties: 1. Point to the Macro list. 2. Select the macro that you want to change. 3. Click the tool button "Properties" to open the properties dialog. Alternatively, you also can right-click the macro and select the item "Properties" under the context menu, and then switch to the "General" tab. Click here to show the figure

General

Macro name A title will appear in the macros list. Description A description for the new macro. Script file name Specifies the script's file name. Password for access Add a password to the macro to prevent unauthorized from accessing your private macro. And you also can specify when the password is necessary. Hotkey for playback Click the button to specify a hotkey combination or phrase, if you'd like to remove the hotkey, click the button "Clear Hotkey". Also, you may attach a condition on the hotkey to make the hotkey available only when specified window is active. Please refer to Hotkey for more information. Repeat playback times Specifies how many times the macro should be played when the key combination is pressed. Notes: If a macro is disabled, you can play manually.

[email protected]

24 / 213

Help for Macro Expert


Changing the scope of macro Every named macro can be restricted to play when a specified window exists. In some cases this is necessary for ensuring the macro's actions to perform right. T o change the scope of macro: 1. Click on the Macro Explorer tab. 2. Select the macro that you want to change. 3. Click the tool button "Property" to open the property dialog. Alternatively, you also can right-click the macro and select "Property" under the context menu, and then click the "Scope" tab. T he scope of macro dialog: Click here to show the figure

Scope

Window caption Finds the window by the caption of windows. Window class Finds the window by the class name of windows. Caption/class name must match exactly Specifies whether to search for whole caption/class name matches. Window state The visual state of the specific window, it can be Minimize, Maximize and Normal. Left of window The x-coordinates of the upper-left corner of the specific window. T op of window The y-coordinates of the upper-left corner of the specific window. Width of window The x-coordinates of the lower-right corner of the specific window. Height of window The y-coordinates of the lower-right corner of the specific window. T his macro will apply to all windows. Specifies whether to search for a specific window that is existed before playing the macro. Notes: You might use the instruction "Wait for a window" to get the same effect. W ith the option "T his macro will apply to all windows." checked, the macro will run immediately without a window existing or not.

[email protected]

25 / 213

Help for Macro Expert


Changing the triggers of a macro

Triggers

Trigger is a way for playing a macro automatically. You can utilize the trigger to complete some unattended tasks. Such as restarting the computer, deleting all of temp file up and so on. T o change the triggers of macro: 1. Point to the Macro list. 2. Select the macro that you want to change. 3. Click the tool button "Properties" to open the properties dialog. Alternatively, you also can right-click the macro and select the item "Properties" under the context menu, and then switch to the "T riggers" tab. Click here to show the figure

Add Adds a trigger to the macro. Edit Changes the parameters of the selected trigger. Remove Deletes the selected trigger from the list. To see more topics about the trigger, please refer to the below links. Overview of Trigger Idle Trigger Startup Trigger System Trigger Resource Trigger Driver Trigger Dial Trigger Notes: The number of trigger is limited to 16.

[email protected]

26 / 213

Help for Macro Expert


Changing the schedule of macro

Schedule

Schedule is another way for playing a macro automatically to triggering. It is based on time, you can specify a macro to run minute, daily, weekly and monthly. T o change the schedule of macro: 1. Point to the Macro list. 2. Select the macro that you want to change. 3. Click the tool button "Properties" to open the properties dialog. Alternatively, you also can right-click the macro and select the item "Properties" under the context menu, and then switch to the "Schedule" tab. Click here to show the figure

Add Adds a scheduler to the macro. Edit Changes the parameters of the selected scheduler. Remove Deletes the selected scheduler from the list. Please refer to the below links for more information about the schedule. Overview of schedule Minute Daily Weekly Monthly At a time Once Notes: To change the schedule of the macro quickly, you can click the icon in the left column of macro list.

[email protected]

27 / 213

Help for Macro Expert


Playback T ab Click here to show the figure

Play back

Show progress window Specifies the progress window whether to show during playback. Dodge mouse pointer Specifies whether automatically to dodge mouse pointer, if so, when the mouse pointer moves over the progress window, the progress window will move to dodge the mouse pointer. You may take the option to ensure the mouse click action to perform correctly on the right window, otherwise, the progress window may be clicked unexpectedly. Initial play speed The initial speed level of playing, the speed can be changed dynamically during the playing by the instruction "Adjust Speed". Initial variable value Specifies the initial value to the variables. Multiple variables may be specified by separating entries with the character &. If you specify multiple values to a variable, the last value will be used, for example: v_var1=123&v_var1=567&v_var1=88, the value of the variable v_var1 will be 88. Emulation level Specifies the emulation level of the mouse and keyboard acvitity. The hardware level emulation will bypass the protection of the most of games. Wait for interval of action accurately Specifies whether to suspend the execution of the action accurately. The option is useful if the performance of the computer hardware is not enough fast, and it may cause high CPU usage with the option checked. If no user is logged on or workstation is locked Specifies an action to perform when no user is logged on or the workstation is locked, the action can be one of the following: Don't run. Run as background user. Run as specified user. User for auto-logon Specifies a user for auto-logon. If "Default user name" is selected, the auto-logon routine first attempts to receive the user name on the logon screen, and then searches for the corresponding password in the user list. For more information, please refer to "Auto-logon". After playing the macro Specifies an action to perform after playing the macro, the action can be one of the following: Do nothing. Back to the previous state. Lock the workstation. Logoff.

[email protected]

28 / 213

Help for Macro Expert


Advance T ab T o change the advance properties of a macro:

Advance

1. Point to the Macro list. 2. Select the macro that you want to change. 3. Click the tool button "Properties" to open the properties dialog. Alternatively, you also can right-click the macro and select the item "Properties", and then switch to the "Advance" tab. Click here to show the figure

Log level Specifies how to log the playing process. The log level can be one of the following: Nothing. All messages and errors. Messages only. Errors and warning. Start a new log file Specifies how to create the log file: Never (unlimited file size) Selects this option and sets the size of the current log file to unlimited. When file size exceeds maximum Creates a new log file when the maximum log file size exceeds a set value. To set the maximum log file size, enters a size, in bytes, in the Maximum File Size box. Daily Creates a new log file daily. Action after completion Specifies an action after completing a unattended playback. The action can be one of the following: Nothing. Disable all triggers. If an error is occurred Specifies an action that should be executed when an error occurs during playing. The action can be one of the following: Stop play. Continue playback. Stop play and disable all triggers. Priority type Specifies the type of playing macro when more than one macro is running. The type can be one of the following: Normal. The macro will be launched regardless of how many macros are running. Limit number of simultaneous of this macro. Limits the amount of running macro that have the same name with the current macro.

[email protected]

29 / 213

Help for Macro Expert

Advance

Limit number of simultaneous macros. Limits the amount of running macro.

[email protected]

30 / 213

Help for Macro Expert

Triggering macro overview

Overview of triggering macro Unlike the scheduler of macro, trigger does not have to be based on a moment in time. It may be based on one or more system events. W henever, a system event occurred and a macro has been triggered with it, the macro will be launched automatically. Macro Expert provides many trigger options for you, the following is the list of available options:

Idle T rigger Launches the macro when your computer enters the idle(no keyboard and no mouse input) state for the specified period of time. Startup T rigger Launches the macro when a user is logged on windows, or windows is started. System T rigger Launches the macro when a system event is occurred, such as time is changed, display resolution is changed, and etc. Resource T rigger Launches the macro when a system resource event is occurred, such as free disk space is low and etc. Driver T rigger Launches the macro when a removable driver is inserted into the computer or removed from the computer. Dial T rigger Launches the macro when a remote access connection is established or terminated. Window T rigger Launches the macro when a window is opened, closed, activated or deactivated.

[email protected]

31 / 213

Help for Macro Expert

Idle trigger

Idle T rigger

[email protected]

32 / 213

Help for Macro Expert

Startup trigger

Startup T rigger

[email protected]

33 / 213

Help for Macro Expert

System event trigger

System T rigger

[email protected]

34 / 213

Help for Macro Expert

Resource event trigger

Resource T rigger

"Free disk space is under" and "Available free memory space is under" are not real time trigger, they will fire for the event every one second.

[email protected]

35 / 213

Help for Macro Expert

Driver trigger

Driver T rigger

[email protected]

36 / 213

Help for Macro Expert

Dial trigger

Dial T rigger

[email protected]

37 / 213

Help for Macro Expert

Hotkey

Hotkey Click here to hide the figure

Parameters Key combination Specifies the hotkey combination you want to use. You may press the key combination in the field or click the right button to choose one. Launch when following window is active Specifies the condition of activating the hotkey. You may use the options to make the hotkey combination only available in a particular window. Play times when key combenation is pressed Specifies the times of playback.

[email protected]

38 / 213

Help for Macro Expert

Window Trigger

Window T rigger Click here to show the figure

Parameters When a window is Specifies which window event should be monitored, it could be "Open", "Close", "Active" or "Deactive". Window title Specifies the title of the windows to be monitored. Window class name Specifies the class name of the windows to be monitored. The class name is specified in the application for indicating a kind of the window. For example, all open Windows Notepad windows have a same class name "Notepad". Match whole words If checked, specifies that the text specified in the field "Window title / Window class name" must match whole words for the window title/class name to be successful. Delay to check a window Use the option to prevent trigger checking a window immediately. The title of windows may changed when the document is completed loaded. Note W hen a window event occurs, the watcher will pass the handle value of the matched window to the player, so that you could use the handle value to perform other task such as maximizing the window, minimizing the window. To retrieve the window handle value, use the global variable "window_watcher_hwnd" in your macro.

[email protected]

39 / 213

Help for Macro Expert

File Trigger

File T rigger Click here to show the figure

Parameters Folder should be monitored Specifies a folder which should be monitored. Include mask Specifies the files/folders to be monitored. Each file name must be terminated by a single semicolon, and standard Microsoft MS-DOS wild cards, such as "*", are permitted. Exclude mask Specifies one or more file names which should be ignored. Each file name must be terminated by a single semicolon, and standard Microsoft MS-DOS wild cards, such as "*", are permitted. The wild cards name "*.*" does not allowed. Include sub folder Specifies whether to monitor the subfolders. File actions Specifies which kind of activity should be monitored. Note The file triggers will work on network drives and shares only if the machine is part of a domain and if the computer Macro Expert is running on has at least Read access to the folder being monitored. The trigger will not work on mapped drives or network shares that belong to a W in9x workgroup. Do not attempt to monitor the windows system directory with the Include mask "*.*" (all files in system direcotry), it will slow down your system. W hen a file event occurs, the watcher will pass the matched file name and action type to the player, you could use the global variable "file_watcher_file" to retrieve the file name, and "file_watcher_action" to determine what event (action) is happen. The value of the global variable file_watcher_action can be one value of the following: 1 -- File or folder is created 2 -- File or folder is deleted 3 -- File or folder attribute is changed 5 -- File or folder name is changed

[email protected]

40 / 213

Help for Macro Expert

Scheduling macro overview

Overview of scheduled macro Every named macro can be scheduled to launch, you can schedule it to run at a specific time that is the most convenient for you, you can also schedule it to launch periodically ( daily, weekly or monthly ). Scheduling a macro is a good idea to perform a task automatically without your supervision. Macro Expert provides many scheduling options for you, the following is the list of available options:

Minute Specifies the macro to launch once every X number of minutes, hours or seconds. Under the schedule type, you could also specify the macro to launch at a random time, for example, between 4 and 10 minutes. Daily This option allows the macro to launch once every X number of days or week days. You can also specify which days of the week that you want the macro to run. Weekly This option allows you select the days of the week to play the macro, you can also be allowed to run every week, every 2 weeks, or every N weeks. Monthly This option allows you play the macro monthly, you can select the date of the month for playing. At a time This option allows the macro to play at a specific time, you can specify up to 32 specific time points. Once This option allows the macro to play at a specific time and only launch one time.

[email protected]

41 / 213

Help for Macro Expert

Minute

Minute Click here to hide the figure

T he time of next launch Specifies a time that you want the macro to begin working. This time will be modified after completing scheduled playback.

[email protected]

42 / 213

Help for Macro Expert

Daily

Daily Click here to hide the figure

T he time of next launch Specifies a time that you want the macro to begin working. Launch this macro Specifies the period of the macro's running, it can be Every day , Every week days, or Every N days.

[email protected]

43 / 213

Help for Macro Expert

Weekly

Weekly

T he date of next launch Specifies a time that you want the macro to begin working. This time will be modified after completing scheduled playback.

[email protected]

44 / 213

Help for Macro Expert

Monthly

Monthly

T he date of next launch Specifies a time that you want the macro to begin working. This time will be modified after completing scheduled playback.

[email protected]

45 / 213

Help for Macro Expert

Once

Once

T he date of launch Specifies a time that you want the macro to execute.

[email protected]

46 / 213

Help for Macro Expert

At a time

At a time Click here to hide the figure

Add a time Adds a specific time which you wan to launch the macro into the list. Edit Changes the selected time. Remove Removes the selected time from the list. Clear Clears all the time from the list.

[email protected]

47 / 213

Help for Macro Expert

General

General T ab Click here to show the figure

Macro files Specifies a folder that contains named macros. Log files Specifies a folder to save the log of playing macro and the log of Macro Service. Language for the interface. Select a language for the interface of Macro Expert, the list will show all available languages. Log the manager message. Specifies whether to record the message and error from the administering operations, such as importing a script, removing a macro, modifying a macro, and etc. Check for updates Specifies how often to check updates. Open main window when Macro Manager starts. If the option is unchecked, the main window will not appear when Macro Manager starts, but you also can open it by clicking the icon on the systray.

Automatically run Macro Manager when I log on to the windows. Please keep in mind, Macro Service will always run even if the Macro Manager is not running, it means a triggered or scheduled macro will be launched yet. To stop this, you must suspend the Macro Expert. Password for Macro Manager Specifies the password for opening and accessing Macro Manager. Notes: The progress window will always show when the process of playing or recording is paused even if it is specified to be invisible.

[email protected]

48 / 213

Help for Macro Expert

Hot keys

Hot keys Click here to show the figure

Pause playing or recording This is a switch, first pressing the hot key will suspend the process of playing or recording, and pressing the hot key again will resume the process. Stop playing or recording W hen this hotkey is pressed, the playing or recording process will abort. Stop Macro Service Stop Macro service, the scheduler, trigger and hotkey for macro will be suspended until the next time of starting service. Record a new macro Create a new macro via the wizard. Record T emporaryMacro Starts a process of recording TemporaryMacro. Play T emporaryMacro Plays the TemporaryMacro. Capture mouse cursor's position This hotkey is valid only in Macro Script Editor, it retrieves the mouse cursor's position. Cancel position capture This hotkey is valid only in Macro Script Editor, it will stop the capture.

[email protected]

49 / 213

Help for Macro Expert

TemporaryMacro

T emporaryMacro T ab Click here to show the figure

Record keystrokes All the keystrokes will be tracked and translated into the macro actions, but the delay of between two keystrokes will not be recorded. Save time interval between two keystokes Records the delay of between two keystrokes. Record mouse actions All the mouse actions except movements will be tracked and translated into the macro actions. Record mouse movements Captures and stores the mouse movements. Mouse position is relative to the screen coordinates to the foreground window to the current position Pause before starting to record T emporaryMacro. Specifies whether to start the recording process at once, otherwise you need to resume the process. Just play one time If this option is unchecked, TemporaryMacro will continuously play until you stop it. Play a sound before playing T emporaryMacro. Specifies whether to play a sound to inform you that macro will start to play. Pause before starting to play T emporaryMacro Specifies whether to play TemporaryMacro at once. Initial speed of playback Specifies the speed level of the playing TemporaryMacro, the value -10 is slowest and the value 10 is fastest.

[email protected]

50 / 213

Help for Macro Expert

Play back

Playback T ab Click here to show the figure

Opacity of progress window. Specifies the opacity level of the progress window. If this value is less than 30, the progress window is invisible; if this value is 100, the progress window is opaque. Make a quick play when pressing the hot key Specifies how to play the macro when the hotkey of a macro is pressed. Pause before starting playback Specifies whether to pause before starting playback. Hide Macro Manager before starting playback Specifies whether to hide the main window of Macro Manager. Progress window automatically dodges mouse pointer. Specifies whether to automatically dodge the mouse pointer during playback. You may take the option to be sure that the mouse click action perform correctly on the window, otherwise, the progress window may be clicked unexpectedly. This is a global option, you also specify the option for every macro, please refer to "Playback" properties of the macro. Default repeat playback times If this value is set to 0, the macro will continuously replay. Play a sound before playing Specifies whether to play a sound before playing the macro. Sound file The wav file for informing.

[email protected]

51 / 213

Help for Macro Expert

Record

Record T ab Click here to show the figure

Record keystrokes All the keystrokes will be tracked and translated into the macro actions, but the delay of between two keystrokes will not be recorded. Save time interval between two keystrokes Specifies whether to save the time interval between two keystrokes. Record mouse actions All the mouse actions except movements will be tracked and translated into the macro actions. Record mouse movements Captures and stores the mouse movements. Mouse position is relative to the screen coordinates to the foreground window to the current position Fill properties after recording. If this option is checked, the recording progress will start immediately rather than ask you to set the options of recording and properties of the new macro. Pause before starting to record a new macro. If this option is checked, the progress of recording will not begin until you resume it. Recording monitor window automatically dodge mouse pointer. Specifies whether the recording monitor window automatically dodge mouse pointer. You may take the option checked to prevent the monitor window from disturbing the process of recording. Play sound for reminding Specifies whether to play a sound to inform before or after recording.

[email protected]

52 / 213

Help for Macro Expert

Macro list

Macro list T ab Click here to show the figure

Move up/down Changes the order of the column. Default Uses the default order for the column. After double-clicking a macro Specifies an action that will take place after double-clicking a macro in the macro list, it can be one of the following: quick play the macro. play the macro. view/modify the properties of macro. edit the script of macro.

[email protected]

53 / 213

Help for Macro Expert

Auto-logon

Auto-logon T ab Macro Expert has an ability to logon or unlock a workstation automatically for playing a macro. It's useful when a macro should be executed but there is no current user or the workstation is locked. Launching a macro while logged off or workstation locked If a macro is triggered while the workstation is locked or the workstation is logged off and waiting for a user to log in. Macro Expert attempts to do one of three ways: Don't run Since most macros require interaction with the desktop, and such interaction can only be done when a user is logged on and the workstation is not locked, this default option provides greatest compatibility with various scenarios. Run as background user Macro Expert will attempt to launch the macro in the background mode. Under this mode, the macro that interacts with application interfaces will not be function correctly. Thus, this option is recommended for non-interactive task, such as file task, database task, and other tasks without user knowledge or intervention. Run as specified user If the workstation is locked or there is no current user. Macro Expert will attempt to unlock or logon, and the macro will be launched if Macro Expert determines that the logon/unlock attempt is successful. Before activating the option, the user name password pairs must be defined for Macro Expert using. For more information about playback of a macro, please refer to "Playback". Click here to hide the figure

Add Adds a user name password pair. Edit Modifies the current user name password pair. Remove Removes the current user name password pair.

[email protected]

54 / 213

Help for Macro Expert

Appearance

Appearance T ab Click here to show the figure

Hue Specifies the hue value of the skin. Saturation Specifies the saturation value of the skin. Present themes A list lists all available predefined color themes. Font name Specifies the font name for the UI. Font size Specifies the font size. Notes: To adjust the value of the hue or the saturation, click on the slider indicator, hold the mouse button down and move it to the left or right.

[email protected]

55 / 213

Help for Macro Expert


Getting familiar with Macro Script Editor

Looking at the work area

The Macro Script Editor is a tool designed to modify the actions of a macro. You can launch it from the macro list of Macro Manager(Right-click the macro which you'd like to edit and select "Edit..."), alternately you can launch it from Start Menu. The work area of Macro Script Editor has three principal areas: Actions list At the left of work area, the actions tree lists all of available actions, you can doubleclick an action to insert one into the script. Variables list At the left-bottom of work area that is a list box. It lists all the user defined variables. Script window For inserting, editing and deleting the actions of script. The following illustration shows you what the Macro Script Editor looks like.

About Script Editor options, please refer Editor Options.

[email protected]

56 / 213

Help for Macro Expert


Inserting an action T here are two ways to insert a new action

Inserting an action

Click the "Insert" from the menu, and select the action that you'd like to insert. Select an action category on the "action list", and then double-click the action item.

[email protected]

57 / 213

Help for Macro Expert


Editing actions T o edit one action

Editing an action

Selects an item that you'd like to edit in the script window, and clicks the "Edit" button on the toolbar or presses RET URN key. T o edit more than one actions Selects the items that you'd like to edit, and presses RET URN key or clicks the "Edit" button on the toolbar. Notes: To disable/enable items quickly, selects the items you'd like to disable/enable, and presses SPACE key. To select more than one items, you need first to select an item, and then press SHIFT and click the mouse or press SHIFT and up or down arrow keys to extend the selection from previously selected item to the current item.

[email protected]

58 / 213

Help for Macro Expert


Removing actions T o remove one action

Removing one or more actions

Selects an item that you'd like to remove in the script window, and presses the DELET E key or clicks the "Remove" button on the toolbar. T o remove more than one actions Selects the items that you wan to remove, and presses the DELET E key or clicks the "Remove" button on the toolbar. Notes: To select more than one items, you need first to select an item, and then press SHIFT and click the mouse or press SHIFT and up or down arrow keys to extend the selection from previously selected item to the current item.

[email protected]

59 / 213

Help for Macro Expert


Working with variables

Working with the variables

Variable is a symbol that can hold temporary values when a macro is playing. You might use it to perform different operations on an action, depending on the value of a variable. In Macro Expert, there are two type variables, the global variables and local variables. It allows you to define up to 256 local variables for a macro. You may utilize Macro Editor to add (define), modify and remove a variable. For more information about the variable and expression, please go here. Adding a local variable Clicks the "Variables" menu, and then selects the menu item "Add a variable...". As an easy way, you can click the button on the variables list. Editing a local variable Selects the variable which you'd like to modify, and clicks the "Variables" menu, and then selects the menu item "Edit variable...". As an easy way, you can click the button on the variables list. Removing a local variable Selects the variable which you'd like to remove, and clicks the "Variables" menu, and then selects the menu item "Remove a variable...". In this case, you can also click the button on the variables list to remove the variable. The below illustration shows you what the variables list looks like.

[email protected]

60 / 213

Help for Macro Expert


General settings and Error Handling Options Error Handling Options

General settings and Error Handling Options

If an error occurred during playing this action, one of the following action should be carry out. T hrow the error Macro Player will throw the error message and stop the playback. Ignore the error Macro Player will ingore the error and continue to play the following actions. Playback log for this action Specifies the log level for this action only, the option will overwrite the log settings of the script. General Parameters Delay before playing this action Specifies the time interval to suspend before playing the action, in milliseconds. Action is enabled Specifies whether the action is enabled or disabled. Notes: For the option "Ignore the error", you can test the global variable "error" to know executing the action OK or not.

[email protected]

61 / 213

Help for Macro Expert


Key actions Simulating a key down, key release or keystroke action to the focused window. Parameters Action type It can be Key down, Key up or Key stroke Key value In this field, you can press a key to retrieve the value of key. Key by expression Specifies an expression to instead of a key value.

Key action

Evaluete expression as a character Specifies how to evaluete the expression. W ith the option checked, the first character of the value of evaluating the expression will be the key value, otherwise, the expression will be evaluated to a number for ASCII code. Shift key Specifies that SHIFT key should be held down or released. Ctrl key Specifies that CONTROL key should be held down or released. Win key Specifies that W IN key should be held down or released. AltGr key Specifies that ALTGR key (available on many European keyboards) should be held down or released.

[email protected]

62 / 213

Help for Macro Expert


Mouse actions

Mouse action

Simulates a mouse action, it can be moving mouse pointer, pressing the mouse button, releasing the mouse button, clicking the mouse button and etc. Parameters Action type It can be Move mouse pointer, Press mouse button and etc. Which button Specifies a button which will be simulated, it can be left, middle or right. position is relative to Specifies how to calculate the mouse cursor's position, it can be one of the following: Relative to the screen coordinates Absolute coordinates, start from the top-left of the screen.

Relative to the foreground window Relative coordinates, start from the top-left of the foreground window.

Relative to the current position Relative coordinates, start from the position of the current mouse pointer.

Pos X Specifies the value for the X coordinate. Pos Y Specifies the value for the Y coordinate. Capture tool It is a tool for retrieving a position of cursor, you can use either dragging or pressing a hotkey to do that. Note: You may use the instruction Image search to retrieve the position of an unfixed icon, button, or other shape. You may use the instruction T ext search based on image to retrieve the position of the specified text.

[email protected]

63 / 213

Help for Macro Expert


Put T ext Putting a text into the focused window, it is more convenient than "Key Stroke " to input information such as your name, address and others. Parameters

Put a Text

Put text into the focused window via the clipboard If this option is checked, the text will first put into the clipboard, and then paste it into the focused window from the clipboard. T ime interval Specifies how long If this option is checked, the text will first put into the clipboard, and then paste it into the focused window from the clipboard. Notes: If the text contains some non-ANSI characters, please check the option "Put text into the focused window via the clipboard", it makes ensure to input the text correctly.

[email protected]

64 / 213

Help for Macro Expert


Mouse Move Activity

Mouse Move Activity

The instruction is different from "Move Mouse", it allows up to 16383 mouse move actions to assemble into one step. It would make editing mouse action more easer than even, you just copy/paste one step to perform moving or duplicating a series of action. Parameters Name Specifies a name for the activity to describe what the activity does. position is relative to Specifies how to calculate the mouse cursor's position, it can be one of the following: Relative to the screen coordinates Absolute coordinates, start from the top-left of the screen.

Relative to the foreground window Relative coordinates, start from the top-left of the foreground window.

Relative to the current position Relative coordinates, start from the position of the current mouse pointer.

Pos X Specifies the value of X coordinate. Pos Y Specifies the value of Y coordinate. T ime interval Sepcifies the minimum time interval for which execution is to be suspended, in milliseconds. Capture tool It is a tool for acquiring the position data of mouse pointer. You press the button 'Acquire' to start, and then drag the pointer to acquire data. T olerance Specifies a time interval to determine how frequently the capture acquires the position data, in milliseconds. Bigger value causes to acquire less amount of the position data.

[email protected]

65 / 213

Help for Macro Expert


Mouse Action on Object

Mouse Action on Object

You can use this instruction to move the mouse pointer to a UI object (user interface object, such as the button, menu item, link and etc.), or click/double click the object. The instruction is different from "Mouse Move", it communicates with the target UI object directly and will continue to work even if the object is moved in subsequent activity. Parameters Carry out action Specifies the action which will be acted on the UI object. Which button Specifies the mouse button to be act. Move mouse pointer to position within object Specifies the position that the mouse pointer should be moved to before carring out the action. The position coordinates are relative to the upper-left hand of the UI object. X Specifies the X of the position in the object, which is relative to the left or right border of the object. Y Specifies the Y of the position in the object, which is relative to the top of the object. X coordiante is right-to-left W ith this option checked, the X will start from right-toleft instead of left-to-right. Notes: For more information about locating a UI object, please refer to "Find a UI object".

[email protected]

66 / 213

Help for Macro Expert


Series Keystrokes Simulating a series of keystrokes to the focused window. Parameters Keystrokes Specifies the keystrokes to send to the focused window.

Series Keystrokes

Keep current foreground window focues value W ith the option checked, the window that is currently at the front when the action starts will be re-focused before simulating each keystroke. Lock keyboard and mouse Specifies whether to lock keyboard and mouse during the execution of the action. The keyboard and mouse will be unlocked automatically when the action is finished. Don't show keystrokes in action list W ith the option checked, the keystrokes will be shown as the asterisk charcters in the Macro Editor. T ime interval value between keystrokes Specifies the delay value between simulating each keystroke. Notes: Each keystroke is represented by one or more characters. You may use the character itself to specify the keystroke. For example, to represent the letter A, use A. To represent special key, you must enclose them in braces. For example, {Backspace}, {Return}. The key combination is allowed, you must use the braces to enclose them as well. For example, {Ctrl+S}, {Shift+A}.

[email protected]

67 / 213

Help for Macro Expert


Display Message Dialog

Display Message Dialog

Display a message dialog for informing something or asking the user to make a choice. As an example, you can insert a Message Dialog action to give user a chance whether to execute the shutting down action before it actually is performed. Parameters Message to display This message will be shown in the dialog. T itle of dialog The title of dialog, it can be NULL. Buttons in the dialog Specifies which buttons need to appear in the dialog. Icon in the dialog Specifies which icon need to be displayed. Action after clicking button Specifies an action that should be executed after the button is clicked. Button selected by default Specifies a button which is as default button, the default button will be focused when the dialog shows. Press the default button after X seconds Specifies the number of seconds to wait before clicking the default button automatically. Return result to variable Specifies the name of an already defined variable that should be populated with the button that has been clicked. The return value is a string, it can be one of the following: OK CANCEL Y ES NO ABORT RETRY IGNORE

[email protected]

68 / 213

Help for Macro Expert


Select a folder

Select a Folder

Select a folder for subsequent actions. For example, you may utilize the instruction to select the source folder or destination folder in a file copying task. Parameters T itle of dialog The title of dialog, it will be displayed in the dialog box, and can be used to inform the user why need to choose a folder. Initial folder Specifies the path of a folder to select, the folder will be located when the dialog popups. Do not show network folder Specifies whether to include network folders below the domain level in the dialog box. Action after clicking "Cancel" button Specifies an action that should be executed after the "Cancel" button is clicked. Retrieve path of folder into variable Specifies the name of an already defined variable that should be populated with the path of the folder. Notes: The variable for the path of folder shouldn't be empty, for more information about the variable, please refer to "Variable and Expression".

[email protected]

69 / 213

Help for Macro Expert


File-selection Dialog

File-selection Dialog

Displays file-selection dialog for a file name. The action can be used for asking a file name during a macro is playing back. Parameters T ype of a dialog Specifies the type of the dialog, it can be "Open file" or "Save as". Initial file name Specifies a default file name which will be placed into the file name field when the dialog shows. Initial folder Specifies a path to be the initial directory. If Initial file name contains a path, that path is the initial directory. Filter of file type Specifies a filter strings. Multi-type should be separated by string \0. The first string in each pair is a display string that describes the filter (for example, "Text Files"), and the second string specifies the filter pattern (for example, "*.TXT"). To specify multiple filter patterns for a single display string, use a semicolon to separate the patterns (for example, "*.TXT;*.DOC;*.BAK"). A pattern string can be a combination of valid file name characters and the asterisk (*) wildcard character. Do not include spaces in the pattern string. After clicking "Cancel" button Specifies an action that should be executed after the "Cancel" button is clicked. Store file name into variable Specifies the name of an already defined variable that should be populated with the full-path file name. Notes: The variable for the path of folder shouldn't be empty, for more information about the variable, please refer to "Variable and Expression".

[email protected]

70 / 213

Help for Macro Expert


Input dialog

Input Dialog

Displays an input dialog box that lets the user enter a value, the entered value will be used in the subsequent actions. For example, you may use the instruction to ask user which type of files should be copied in a file copy task. Parameters Prompt string The title of dialog, it will be displayed in the dialog box, and can be used to inform the user why need to input a value. Initial value Specifies a default value. Format of value Specifies which format of value is allowed. For example, if the option is "Only numeric is allowed" and the user enter a string "abc", an error message box will popup when "OK" button is clicked. Value must not be empty W ith the option checked, the "OK" button will be grayed if there is nothing in the input field. Press OK button after x seconds Specifies whether to automatically press OK button. Action after clicking "Cancel" button Specifies an action that should be executed after the "Cancel" button is clicked. Store entered value into Specifies the name of an already defined variable that should be populated with the entered value. Convert value to Specifies how to store the value. Notes: The variable for the input value shouldn't be empty, for more information about the variable and data type, please refer to "Variable and Expression".

[email protected]

71 / 213

Help for Macro Expert


Show T ips T ext Displays a window and show the tips text. The instruction is useful before a long-time operation is about to go. You also use it to inform the user something.

Show Tip Text

Unlike the instruction "Message Dialog", the player will not wait for the user to click a button, it immediately go to the next step once the tips window is opened. Parameters T itle Specifies the title of the tips text. Message Specifies the content of the tips text. Hide message window automatically after x second Specifies whether to hide the window automatically. If the option is checked, the window will be closed automatically. Otherwise, the windows must be closed by the action "Hide Tips Text". T ext window position is relative to Specifies the position of the left-top corner of the window, it can be one of the following.: Relative to the screen Relative to the foreground window Relative to the current cursor position Center in the screen Window Size Specifies the size of the window.

[email protected]

72 / 213

Help for Macro Expert


Hide T ip T ext

Hide tip text

Hides the window of the tip text. The action will not effect if there is no a tip text showing.

[email protected]

73 / 213

Help for Macro Expert


Choice dialog

Choice Dialog

Displays a multiple choice dialog box that prompts user for a choice. It's useful when the user must make a decision that will effect the execution of the subsequent steps. Parameters Prompt string The title of dialog, it will be displayed in the dialog box, and can be used to inform the user why need to input a value. List type Specifies how to list the items. It can be one of the following: Dropdown combobox Droplist List box Radio option Check box Items Specifies the items for multiple selection. Each item should be separated by the semicolon characters. Initial value Specifies a default value. Return value-type Specifies to return whether the text of the selected item or its 0based index number. Populate variable with result Specifies a variable to store the selected item. Multipleselection will be separated by the semicolon characters. Action after clicking "Cancel" button Specifies an action that should be executed after the "Cancel" button is clicked. Force selection Specifies that the user must make a valid selection before continuing. Allow multiple selections for list Specifies whether to allow multiple selections for the list. Press OK button after x seconds Specifies whether to automatically press the OK button. Notes: The variable for selected items shouldn't be empty, for more information about the variable and data type, please refer to "Variable and Expression".

[email protected]

74 / 213

Help for Macro Expert


Window Actions Shows, closes, activates, resizes, moves a specified window. Parameters

Window action

Which window Specifies a window to be manipulated. Please see the "W hich W indow" Action Specifies an action that should be applied to the window. The action can be one of the following: Activate Shows the window and brings it to the front. Close Sends a request to the windows for closing. Move Changes the position of the specified window. Hide Hides the window and activates another window. Show Activates the window and displays it in its current size and position. T opmost Places the window to above all windows. Cancel topmost Places the window to behind all topmost windows. Resize Changes the dimensions of the specified window. Maximized Activates the window and displays it as a maximized window. Minimized Activates the window and displays it as a minimized window. Restore Activates and displays the window. If the window is minimized or maximized, it will be restored to its original size and position. Opacity Sets the window transparent level (0-255), the value 0 will hide the window. Find window Searches for a window and return the handle value of the matched window. Return window's handle into Specifies a variable for receiving the handle of window, the window handle can be used in sequent actions for another purpose. Notes: The handle of window is a number that uniquely identifies a window in windows.

[email protected]

75 / 213

Help for Macro Expert


Delay Waits for some milliseconds, seconds, minutes or hours. It holds the execution of macro until the time is elapsed. Parameters Delay to wait for Specifies a time value for waiting.

Delay

[email protected]

76 / 213

Help for Macro Expert


Wait for a window

Wait for a window

Pauses the execution of macro until a specific window is existed, focused or etc. If the window exists, you can show or focus it. Parameters Which window Specifies the window to be waiting. Wait for the specific window is Specifies the wait type, it can be one of the following: existed not existed focused not focused Window action If the window is existed, you can add an action to it, it can be one of the following: none show maximized minimized restore Return window's handle into Specifies a variable for receiving the handle of window, the window handle can be used in the subsequent action for another purpose. Notes: For time-out options, please refer to "Time out". If the wait type is "not focused" and the window is not existed, the action always succeeds.

[email protected]

77 / 213

Help for Macro Expert


Wait for Color

Wait for color

Suspends the playback until the specified color of pixel changes to the given color, or to any other color. It's very useful to wait completing an action on an application, because in most of case an action may cause certain pixels color changed in the application's window. Parameters Wait until specified: Specifies how to wait the pixel color, it can be the following: pixel color is sam as specified color pixel color is not sam as specified color pixel color is changed

position is relative to Specifies how to calculate the value of the location coordinates, it can be one of the following: Relative to the screen coordinates Absolute coordinates, start from the top-left of the screen.

Relative to the foreground window Relative coordinates, start from the top-left of the foreground window.

Relative to the current position Relative coordinates, start from the position of the current mouse pointer.

Pos X Specifies the value of X coordinate. Pos Y Specifies the value of Y coordinate. Color of pixel Specifies the color of pixel for comparing during playback. Match color value exactly Specifies how to compare the color value, matching exactly or similarly. T olerance Specifies the tolerance value for the case of Match color value exactly not (unchecked). Pick coordinates and color (Capture tool) A tool for picking position coordinates and color. Just moves the mouse pointer to the right box and drags it to the desired position, and then releases the mouse key. Picked by Hotkey Clicks the button to enter the picking state, and simply moves the mouse pointer around the target position and then presses the hotkey. Notes: For time-out options, please refer to "Time out". The tolerance value must be a number from 0 to 255, the value 0 is same as Match color value exactly

[email protected]

78 / 213

Help for Macro Expert


Wait for Keystroke Pauses the execution of macro until a specific key is pressed. Parameters

Wait for keystroke

Keystroke combination Specifies which key or key combination to be waited, leaving the field blank indicates to wait for pressing any key. Which window should be topmost Specifies a window limition for the keystroke. It does mean to pause the execution of the macro until the specific window has the focus and the key combination is pressed. Return pressed key into variable Specifies a variable for receiving the pressed key, the value can be used in the subsequent action for another purpose. Notes: For time-out options, please refer to "Time out".

[email protected]

79 / 213

Help for Macro Expert


Wait for Mouse Motion Pauses the execution of macro until a mouse motion is occurred. Parameters Wait for Specifies a mouse motion. Which button Specifies which mouse button must be pressed.

Wait for mouse motion

Detect whether a key is pressed Specifies whether to detect a key combination. Limit in area Specifies a rectangle in which the mouse motion should be occurred. Return mouse position Specifies the variables that receives the screen coordinates of the mouse cursor. Notes: For time-out options, please refer to "Time out". For more information about the variable, please refer to "Variable and Expression".

[email protected]

80 / 213

Help for Macro Expert


Wait for File Pauses the execution of macro until a specific file is existed or not. Parameters Wait type Specifies to wait for the file to create, remove. File name Specifies the path name of the file. Notes: For time-out options, please refer to "Time out".

Wait for file

[email protected]

81 / 213

Help for Macro Expert


Wait for Process Pauses the execution of macro until a specific process is running or not. Parameters Wait type Specifies to wait for the process to open, close.

Wait for process

Process image name Specifies the process name, it should not be full path name. Search process in a user account Specifies the account name in which the process is running or not. Return full path name of process into variable Specifies the variable to receive the full path name of the process. Notes: For time-out options, please refer to "Time out".

[email protected]

82 / 213

Help for Macro Expert


On Error

On Error

Specifies how to do when an error occurs. W ithout an On Error action, any error will cause the exection stops. Parameters When an error occurs Specifies how to do when an error ocuurs. It can be one of the following: Stop playback Ingore the error and continue Goto Beep when an error occurs Specifies whether to alarm the user when an error occurs during playback. Play an audio file Specifies a wav file to play instead of the simple tones on the speaker. Note: This instruction can only affect the subsequent steps.

[email protected]

83 / 213

Help for Macro Expert


Play Control Pause Indicates to pause the execution of macro until the user resumes. Stop

Play speed

Stops the execution of macro, if the macro needs to run many times, it will play again. End Stops the execution of macro regardless of how many times the macro need to play back. Adjust speed Adjusts the level of the playing speed, between -10 to 10(-10 is the slowest and 10 is the fastest).

[email protected]

84 / 213

Help for Macro Expert


Play a Macro

Play a macro

Play a macro. The instruction is useful for reusing code so the same task does not have to be written over and over again. Parameters Macro is in macro folder Specifies a script file in the macro folder, the path will be converted into a relative path. Macro is not in macro folder Specifies a full path of the script file. Password for playback Specifies the password for playback the macro, it will ignore the value if the macro does not protected by password. Initial variable value Specifies the initial value to the variables in the macro. Note: If the sub task (macro) needs to access the data in this script, like as variables, documents, webpages and datasets, the option "Wait until playback of macro is completed" must be checked. For more options for "Play a Macro ", please refer to "Advanced Options". The Macro is in macro folder is good choice if the destination script file is stored in the macro folder, so when the entire macro folder moves to a new position, the macro player still locate the script file.

[email protected]

85 / 213

Help for Macro Expert


Set emulation level

Set emulation level

Sets the emulation level for the mouse and keyboard activity. The level can be normal level or low-level level. For the low-level, MacroPlayer will emulate the mouse and keyboard actions by accessing the hardware. This will ensure the activity to be played correctly in the most of games. Notes: This action will only influence the subsequent actions. If you'd like to set the emulation type for the range to the entire script, please set the option on the play option dialog.

[email protected]

86 / 213

Help for Macro Expert


Block/unblock mouse and keyboard Block

Block/unblock mouse and keyboard

Block the mouse and keyboard, real physical input from the mouse or keyboard will not affect. Unblock Enable the mouse and keyboard. Notes: Pressing Ctrl+Alt+Del will re-enable the mouse and keyboard.

[email protected]

87 / 213

Help for Macro Expert


Log a playback message Write a message into the playback log file. Parameters Content Specifies the content

Log a Playback Message

Log type Specifies the type of the content, it can be Message, Warning, or Error. Always write W ith this option unchecked, the content will be written into log file depend on the log level of the macro. Write message in debug mode (play in Macro Editor) W ith this option checked if the content is only for the debugging purpose. To play the macro in the debug mode, open the script file in the Macro Editor, then click menu "Play".

[email protected]

88 / 213

Help for Macro Expert


Increase/Decrease value Increase or decrease the value of the variable by a step value. Parameters

Increase/Decrease value

Step value Specifies the value of step for increasing the value of the variable. The step value must be a number. Increase/decrease first character for string The option is useful to increase/decrease the alphabet, and it's only available for the string value. Notes: For more information about the expression, please refer to Variable and Expression. If the current value of variable is not a number(example: string "abc"), it will be as number 0.

[email protected]

89 / 213

Help for Macro Expert


Set Variable Value Set a value to the variable. Parameters Value The value can be a number, a string or an expression. Variable value is plain-text W ith the option checked, the value will store into the variable without any preprocessing. Convert value to Specifies how to store the variable, it can be the following: String value Numberic value Datetime value Binary value Notes:

Set value

For more information about the expression, please refer to Variable and Expression.

[email protected]

90 / 213

Help for Macro Expert


Advanced Set Variable Value

Advanced Set Variable Value

This instruction is only for the advanced user who has experience in programing. Set the value of a variable and resize the variable's buffer. The instruction is useful to the instruction "Call an External DLL". The user uses the instruction to initialize the variable which would be a parameter for DLL function. Parameters Variable name Specifies the variable's name. Convert value to Specifies how to store the variable, it can be the following: Does not change the content in variable Clears the content in variable Stores as string value Stores as number value Stores as datetime value Stores as binary value Offset Specifies the start position of writing value in the variable buffer. Variable value Specifies the content to be stored into the variable. Variable value is plain-text W ith the option checked, the specified variable value will store into the variable without any preprocessing. Reallocate variable space Specifies the new size for the variable's buffer, it expends the buffer automatically. If the size less than the current data size, the rest data will be truncate. Set data size as well Specifies the new size of the variable data. The option is useful when the variable is used to retrieve the data from an exteran DLL API because the most API function just places the data into the buffer without the length of the data. Limit block size of writing By default, the specified content will be written and the variable's buffer automatically extends to fit the size of the content. W ith the option checked, the size of the writing will be limited in the specified length. In bytes The option is only avaiable if the variable data type is the string. In this application, each character nestling snugly into two bytes (UNICODE) of storage and the unit of string value is the character. W ith the option checked, the unit of parameters in this instruction will treat as the byte. Syntax of expression 1. String value The content should be a standard expression. 2. Datetime value The content must be quoted by the number sign '#', for example: #2007-01-01 08:30#. 3. Number value Supports hexadecimal notation, for example: 0x01a. 4. Struct data(Binary data) The structural data should be declared by the following syntax: <Data type code>:<content 1>; <Data type code>:<content 2>; ...

[email protected]

91 / 213

Help for Macro Expert


<Data type code>:<content n>; Code of Data Short T ype Code Integer I Long L Byte B Data T ype Integer Long Byte Text in S[length] DBCS Description

Advanced Set Variable Value

2 bytes, the hexadecimal notation 0x is supported. 4 bytes, the hexadecimal notation 0x is supported. 1 bytes, the hexadecimal notation 0x is supported. The member's size will be determined by the optional String[length] length or the actual size of the content. If the character space is included in the text, the text Text in must be quoted by the single or double quotation marks. W String[length] W [length] Unicode In this case, the quotation marks could be represented by \' or \". Date 16 bytes (same as SY STEMTIME in W indows API), the Date D and content should be quoted by the number sign '#'. time Pointer P Pointer 4 bytes, a pointer to the buffer of a variable.

Example A: Integer:10; Long:200; Date:#2007-09-20#; Pointer:v_size; Example B: String:Hello; Long:200; String260:"Jack Lee"; Example C: (short code of data type) S:Hello; L:0x200; S260:"Jack Lee"; Note: For more information about the expression, please refer to Variable and Expression. For the maximum compatibility, the members in the structural data always be aligned on natural boundaries.

[email protected]

92 / 213

Help for Macro Expert


Advanced Get Variable Value

Advanced Get Variable Value

This instruction is only for the advanced user who has experience in programing. Retrieve the content from a variable's buffer in the binary data manner. In many cases, after calling function in an external DLL, the return result will be stored as a structural data manner in the variable's buffer. You have to use this instruction to retrieve the member value from the buffer. Parameters Variable name Specifies the variable to read. Read method Specifies how to convert the read content. Offset to read Specifies the offset position to the begin of the variable's buffer, in bytes or characters. Limit block size of reading Specifies whether to limit the amount of the content, in bytes or characters. In bytes W ith the option unchecked, it reads the content in characters for the string type. Return value into Specifies the variable for storing the read content. Convert to UNICODE text If the read content is the text in ANSI format, then must check this option to convert it into UNICODE. Note: The offset position is the key for reading the member value correctly, and you have to compute the right value before using the instruction.

For more information about the expression, please refer to Variable and Expression.

[email protected]

93 / 213

Help for Macro Expert


Redefine Variable Redefines the variable. Parameters Variable name Specifies the name of the variable to be redefined.

Redefine Variable

Variable type Specifies the variable type, it can be "General", "1-dimensional array", "2-dimensional array", or "3-dimensional array". Set variable value Specifies how to deal with the variable value, it can be the following: Does not change the data in variable Clear the data in variable String value Number value Date/time value Initial value Specifies the variable value. Variable value is plain-text Specifies whether to evaluate the initial value as an expression. W ith the option checked, the value will store it into the variable directly. Notes: For more information about the expression, please refer to Variable and Expression.

[email protected]

94 / 213

Help for Macro Expert


Convert T ext Converts the text into lower case, upper case, or capitcal letter. Parameters T ext Specifies the text to be converted. Convert method Specifies how to conver the text.

Convert Text

Populate variable with converted text Specifies a variable to hold the converted string. Note: About the variable, please refer to "Variable and Expression"

[email protected]

95 / 213

Help for Macro Expert


Pad T ext Pads the text with the specified content. Parameters T ext Specifies the text expression to be search.

Pad Text

Padding position Specifies the padding location, it can be begin, end, and both begin and end. T ext to pad with Specifies the string to use as the padding content. Padding type Specifies how to pad the text, it can be fixed target length, or repeatd x number of times regardless of the text length. Length Specifies the target length of the text after padding. Amount Specifies the number of the repeat times. Populate variable with padded text Specifies a variable to hold the padded text. Note: About the variable, please refer to "Variable and Expression"

[email protected]

96 / 213

Help for Macro Expert


Split T ext Splits the text and store the sub strings into an array. Parameters T ext Specifies the text to be splitted.

Split Text

Separator character Specifies the character to be used to delimit the substring in the text. Populate array with substrings Specifies the name of the variable/array, the variable will be redefined to fit the splitted result. Populate variable with amount of substrings Specifies the name of the variable to store the amount of the substrings. It also to be the size of the array. Note: About the variable, please refer to "Variable and Expression"

[email protected]

97 / 213

Help for Macro Expert


T rim T ext Trims the whitespace from the text. Parameters T ext Specifies the text to be trimmed. Convert method Specifies how to trim the text.

Trim Text

Populate variable with trimmed text Specifies a variable to hold the result string. Note: About the variable, please refer to "Variable and Expression"

[email protected]

98 / 213

Help for Macro Expert


Find T ext Searches and extracts a substring in a text. Parameters T ext Specifies the text expression to be search.

Find Text

Start position Specifies the The zero-based index of the first character in this CStringT object that is to be included in the extracted substring. Find what Specifies the sub string to search for. Match case Specifies the searching is case-sensitive or not. Use regular expression Specifies whether to use regular expression. W ith this option unchecked, you may also use wildcards such as asterisks (*) and question marks (?) in search string. Populate variable with matched text Specifies a variable to hold the matched string. Populate variable with next start position Specifies a variable to hold the next start position, the next start position is calculated by the follow formula: next start position=first occurrence position + size of matched string Note: For more information about regular expression, you may visit at http://en.wikipedia.org/wiki/Regular_expression. About the variable, please refer to "Variable and Expression"

[email protected]

99 / 213

Help for Macro Expert


Replace T ext Searches and replaces a substring in a text. Parameters T ext for replacing Specifies the text will be searched and replaced.

Replace Text

Start position Specifies the The zero-based index of the first character in this CStringT object that is to be included in the extracted substring. Find what Specifies the sub string to search for. Replace with Specifies the substitution string. To remove the sub string from the variable, left the field blank. Match case Specifies the searching is case-sensitive or not. Replace all Specifies whether to replace the next matched string or replace all matched. Use regular expression Specifies whether to use regular expression. W ith this option unchecked, you may also use wildcards such as asterisks (*) and question marks (?) in search string. Populate variable with number of substitutions made If the sub string (pattern) is not found, return value is 0. Populate variable with next start position Specifies a variable to hold the next start position, the next start position is calculated by the follow formula: next start position=first occurrence position + size of substitution string Note: For more information about regular expression, you may visit at http://en.wikipedia.org/wiki/Regular_expression. About the variable, please refer to "Variable and Expression"

[email protected]

100 / 213

Help for Macro Expert


Format Datetime Converts a datetime value to the text. Parameters Datetime Specifies the datetime value.

Fomat Datetime

Format string type Specifies how to format the datetime, it can use the system default format string. Date format string Specifies the format string for the date part, it can be "none" to ignore the date part of the datetime. T ime format string Specifies the format string for the time part, it can be "none" to ignore the time part of the datetime. Populate variable with converted text Specifies a variable to hold the converted string. Note: The below tablie lists the notations to be used to specify how dates and times are displayed: T ime notations h m s tt h H Date notationsT his d dddd M MMMM yy yyyy Displays Hour (hh displays the hour with a leading zero) Minute (mm displays the minute with a leading zero) Second (ss displays the second with a leading zero) A.M. or P.M. 12 hour time display (hh displays the hour with a leading zero) 24 hour time display (HH displays the hour with a leading zero) Displays Day (dd displays the day with a leading zero) Day of the week Month (HH displays the month with a leading zero) Full month name Year in short format Year in long format

[email protected]

101 / 213

Help for Macro Expert


Comment

Comments

You can insert comments in the macro that do nothing during playback, it only reminds yourself to do something or describing something under the Macro Editor.

[email protected]

102 / 213

Help for Macro Expert


Separator Line

Separator line

Like 'Comments', Separator line does nothing during playback. It is just for parting two action block in Macro Editor.

[email protected]

103 / 213

Help for Macro Expert


Label Labels a point in a macro. It can be used with the instruction "Goto" or other jump flow instructions to direct macro execution to a different point of the macro.

Label

[email protected]

104 / 213

Help for Macro Expert


Goto This instruction changes the point of the macro execution to a different point of the macro. Parameters Label Specifies the name of a label that has been defined in a macro.

Goto

[email protected]

105 / 213

Help for Macro Expert


If Variable Conditionally play a set of steps based on the value of a logical expression. If the logical expression evaluates to TRUE, any steps following 'If' and preceding 'Else' or 'End If' (whichever occurs first) are played.

If variable

If the logical expression evaluates to 'FALSE' and 'Else' included, any steps after 'Else' and before 'End If' are Played. If the logical expression evaluates to 'FALSE' and 'Else' not included, Macro Player will goto the first step following 'End If' and any steps between 'If' and 'End If' are ignored. Parameters Variable Spcifies the name of variable to be evaluated. Comparison operator Specifies the comparison operator, it should be Equal, Not equal, Less than, Greater than, Contain and Not contain. Value for comparing Specifies an expression of value. Match case for string value Specifies whether to distinguish between uppercase and lowercase characters if the variable holds a string value. Remark: Since the variable can hold many types of value, such as string, number or date-time, Macro Player will be applied to the following evaluation rule: Operator Equal Rule If the option 'As a string' is checked, Macro Player considers the value as a string and then to evaluate the logical expression, otherwise, Macro Player will convert the value to number before evaluating. Example: if 'As a string' is checked, the variable holds a string value "12.05" and the parameter 'value' is "12.0500", Macro Player directly compares "12.05" and "12.0500" and get the result FALSE. if 'As a string' is unchecked, Macro Player first converts "12.05" to a number 12.05, and converts "12.0500" to a number 12.05, and then evaluates the expression "12.05 equal 12.05", the result will be TRUE. Not equal Sames as Equal Less than Value will be converted into a number to evaluate. Example: if the variable holds a string value "abc" and the parameter 'value' is "34jdc", Macro Player will convert "abc" to number "0" and "34jdc" to number "34", and then evaluate the logical expression "0 less than 34", the result will be TRUE. Greater than Contain Sames as Less than Value will be as a string to evaluate. Example: if the variable holds a number "1234" and the parameter 'value' is "34", Macro Player will evaluate the logical expression to the result TRUE.

[email protected]

106 / 213

Help for Macro Expert


Not contain Sames as Contain

If variable

[email protected]

107 / 213

Help for Macro Expert


If Color

If color

Conditionally play a set of steps based on the value of a pixel's color. If the color value meets the criteria, any steps following 'If Color' and preceding 'Else' or 'End If' (whichever occurs first) are played. Parameters Compare type: Specifies how to compare the pixel color, it can be the following: pixel color is sam as specified color pixel color is not sam as specified color pixel color is changed Within X seconds For "Pixel color is changed" only, it specifies the number of seconds to wait for the pixel color. position is relative to Specifies how to calculate the value of the location coordinates, it can be one of the following: Relative to the screen coordinates Absolute coordinates, start from the top-left of the screen.

Relative to the foreground window Relative coordinates, start from the top-left of the foreground window.

Relative to the current position Relative coordinates, start from the position of the current mouse pointer.

Pos X Specifies the value of X coordinate. Pos Y Specifies the value of X coordinate. Color of pixel Specifies the color of pixel for comparing during playback. Match color value exactly Specifies how to compare the color value, matching exactly or similarly. T olerance Specifies the tolerance value for the case of Match color value exactly is not (unchecked). Pick coordinates and color (Capture tool) A tool for picking position coordinates and color. Just move the mouse pointer to the right box and drag it to the desired position, and then release the mouse key. Picked by Hotkey Click the button to enter the picking state, and simply move the mouse pointer around the target position and then press the hotkey. Notes: The tolerance value must be a number from 1 to 255.

[email protected]

108 / 213

Help for Macro Expert


If File Exists Conditionally play a set of steps based on the specified file/folder's state. If the logical expression evaluates to TRUE, any steps following 'If' and preceding 'Else' or 'End If' (whichever occurs first) are played. Parameters Criteria type Specifies the criteria type. Filename or folder path Specifies the filename or path of the folder.

If File Exists

[email protected]

109 / 213

Help for Macro Expert


If Window Exists

If Window Exists

Conditionally play a set of steps based on the specified window's state. If the logical expression evaluates to TRUE, any steps following 'If' and preceding 'Else' or 'End If' (whichever occurs first) are played. Parameters Criteria type Specifies the criteria type. Which window Specifies a window to search for. Return window's handle into Specifies the name of the variable to which stores the handle of matched window.

[email protected]

110 / 213

Help for Macro Expert


Select Case Executes one of several groups of actions, depending on the value of an expression. Parameters Expression Specifies a numeric or string expression. Note: Select Case action can be nested. Each nested Select Case action must have a matching End Select action.

Select Case

The "Case Else" is not required, it is a good idea to have a Case Else action in your Select Case block to handle unforeseen values. If no Case expressionlist matches expression and there is no Case Else action, execution continues at the action following End Select.

[email protected]

111 / 213

Help for Macro Expert


Loop

Loop

Play a set of steps(steps block) quoted with the instruction 'Loop' and 'End loop' for a number of times. A. Loop a number of times Parameters Loop a number of times Specifies the number of loops to be performed. Variable for intermedial counter value Specifies a variable to store the complete times of loop. B. Continuous loop Parameters Variable for intermedial counter value Specifies a variable to store the complete times of loop. C. Loop through a range Parameters Initial value of counter Specifies the number for the initial value of the counter. Final value of counter Specifies the number for the final value of counter. Increment or decrement by step Specifies the step value for each time through the loop. Variable for intermedial counter value Specifies a variable to store the intermedial counter value. D. Loop if variable Loop until the expression is FALSE. Parameters Variable name Specifies the name of the variable which should be evaluated. Comparison operator Specifies the operator. Value for comparing Specifies the value expression for comparing with the variable. As string value to evaluate Specifies whether to convert the variable to a string before evaluating. Note: In the case 'Loop through a range', you may specify the 'step value' less than the number 0 to decrease the counter value each time the loop repeats.

[email protected]

112 / 213

Help for Macro Expert


Loop Windows Loops through all of the windows that are currently opened on the system. Parameters Search type Specifies how to search the windows.

Loop Windows

Include mask Specifies the include mask. It can include multiple masks separated by semicolons(;). For example, the include mask *pad;*Explorer; specifies to include all window titles ending with the text Explorer or pad in the title. Exclude mask Specifies the wildcard mask for windows that should be excluded from the loop. Allow hidden windows Specifies whether to search the hidden windows. Multiple masks should be separated by semicolons(;). Match case Specifies whether searching is case-sensitive or not. Store handle of window into (Optional) Specifies a variable that should be populated with the handle of the window on each successive loop. Store text of window into (Optional) Specifies a variable that should be populated with the window text on each successive loop. Note: The window handle is a special number value that W indows System assigns to a window each time it is created.

[email protected]

113 / 213

Help for Macro Expert


Loop Files Loops through all of the files contained in the specified folder. Parameters Source folder Specifies the folder that should be scanned for files.

Loop Files

Include mask Specifies the include mask. It can include multiple masks separated by semicolons(;). For example, the include mask *.txt;*.bmp; specifies to include all files that have the extension txt or bmp. Exclude mask Specifies the wildcard mask to exclude the files from the loop. It can include multiple masks separated by semicolons(;). Include folders Specifies whether to include the folders. Include subfolders Specifies whether the search extends to the subfolders of the Source folder. Match case Specifies whether searching is case-sensitive or not. Store file name into (Optional) Specifies a variable that should be populated with the file name on each successive loop. Do not include path (filename only) Specifies whether to return the path information of the file. Note: You could filter files based on the attribute settings of the source files. For more information, please refer to Attributes Filter.

[email protected]

114 / 213

Help for Macro Expert


Loop Processes

Loop Processes

Loops through all of the process ran on system, or all of the modules contained in specified process. Parameters Search scope Specifies whether to search for the processes or the modules. Search processes under specified user account If yes (checked), it will only search the process are running under the specified user account. Process ID Specifies the process ID of the process that will be scaned. Include mask Specifies the include mask. It can include multiple masks separated by semicolons(;). For example, the include mask *er.exe; specifies to include all processes/modules that name are ended with the text er.exe. Exclude mask Specifies the wildcard mask to exclude the processes/modules from the loop. It can include multiple masks separated by semicolons(;). Return process ID/module handle into (Optional) Specifies a variable that should be populated with the process's ID or module's handle on each successive loop. Return file name into (Optional) Specifies a variable that should be populated with the file name of the process or module on each successive loop. Do not include path (filename only) Specifies whether to return the path information of the file.

[email protected]

115 / 213

Help for Macro Expert


Loop Control Continue Loop

Loop Control

Directly back to the 'Loop' step. 'Continue Loop' can be placed anywhere between 'Loop' and 'End Loop'. Exit Loop Exit the loop and goto the first command following 'End Loop'. 'Exit Loop' can be placed anywhere between 'Loop' and 'End Loop'.

[email protected]

116 / 213

Help for Macro Expert


Run ... Launch a program or open a document. Parameters Program or document file Specifies a file that you'd like to run or open. Parameters If the Program or document file is an application, this field specifies the parameters to be passed to the application. Windows startup Specifies how the application to be displayed when it is opened. After launching application Specifies an action to be executed when the application or document is opened. Return main window into Specifies a variable for storing the handle value of the main window. If the program does not have a window (a console program for example), the value 0 will be returned.

Run

[email protected]

117 / 213

Help for Macro Expert


End Process Kill the instances of running process. This action will get any data changes made in the processes lost. Parameters

End Process

Process name Specifies the process name, it can not contain the path. For example: notepad.exe Search processes under user account Specifies whether to search for the process limit in an account. If more than one maching process is found Specifies how to deal with the multiinstances of running process. Force to terminate process W hen enabled, the process will not be given the chance to save its state.

[email protected]

118 / 213

Help for Macro Expert


Image search

Image search

Searches the specified image in the specified area on the screen, and then carry out a mouse motion at the position. The position coordinates value X and Y could be retrieved for the subsequent actions as well. It's very useful when you have to click on an unfixed position icon, button, or other shape. Parameters Image file name Specifies an image which is stored in the bitmap format to search. Key color for transparency Specifies the color value. All pixels that are similar to the color will be ignored during searching. Match exactly Specifies whether to match the search image exactly in the area. Search in a specified area Specifies the area for searching. Notes: About the options after searching, please refer to "After Searching" If the image does not locate in the area, the coordinates value -1, -1 will be returned, and an error will throw. You may use the instruction "T ext search based on image" to retrieve the position of a string appeared on the screen.

[email protected]

119 / 213

Help for Macro Expert


T ext search based on image

Text earch based on image

Searches a text on the screen, and then carry out a mouse move or click action. The text first will be converted into an image, and then the searching routine searches for the image in the specified area on the screen. If a match is present, the X and Y coordinates could be retrieved for the subsequent actions as well. Unlike the instruction "Image search", you just specify a string rather than a bitmap file. Parameters T ext to search for Specifies the text should be searched. Font Specifies the font name, size and other parameters. These parameters should be consistent with the text on the screen, otherwise, the searching may fail. Match image exactly Specifies whether to match the text image exactly in the area. Search in a specified area Specifies the area for searching. Notes: About the options after searching, please refer to "After Searching". If the text does not locate in the area, the coordinates value -1, -1 will be returned, and an error will throw. You may use the instruction "Image search" to retrieve the position of an icon, button, or other shape.

[email protected]

120 / 213

Help for Macro Expert


Get pixel from point Retrieves the color value of the pixel at the specified position. Parameters

Get Pixel from Point

position is relative to Specifies how to calculate the value of the location coordinates, it can be one of the following: Relative to the screen coordinates Absolute coordinates, start from the top-left of the screen.

Relative to the foreground window Relative coordinates, start from the top-left of the foreground window.

Relative to the current position Relative coordinates, start from the position of the current mouse pointer.

Pos X Specifies the value of X coordinate. Pos Y Specifies the value of Y coordinate. Populate variable with color value Specifies a variable for storing the received color value. The color value will be stored in the number format. Pick coordinates A tool for picking position coordinates and color. Just move the mouse pointer to the right box and drag it to the desired position, and then release the mouse key. Picked by Hotkey Click the button to enter the picking state, and simply move the mouse pointer around the target position and then press the hotkey.

[email protected]

121 / 213

Help for Macro Expert


Registry Operation

Registry Operation

The registry is a system-defined database in which applications and system components store and retrieve configuration data. The instruction "Registry Operation" give you an ability to create a key, remove a key, create a value item, remove a value item, read a value item and set a value item. Parameters Action T ype Specifies the operation type, it can be one of the following: Create a registry key Remove a registry key Create a registry value Remove a registry value Read a registry value Write a registry value Remove all subkeys and values Registry Key Specifies the name of the registry sub-key. Value name Specifies the name of the registry value item. Value Specifies the value of the registry value item. Read value into variable Specifies the variable for storing the read data. For more information about the variable, please refer to "Variable and Expression" Remove all sub-keys and values Specifies whether to remove all sub-keys and values under the registry key, if the option is unchecked and the registry key includes one or more subkeys then the operation will fail. Data type of value Specifies the data type of the registry value, it can be one of the following.: String value Numeric key Notes: The name of the registry key and registry value item is not case sensitive. To access a registry key's default of unnamed value item, just leave the value name field blank. The difference bwteen "Remove all subkeys and values" and "Remove a registry key" is the action "Remove a registry key " will remove the registry key self.

[email protected]

122 / 213

Help for Macro Expert


Call an External DLL

Call an External DLL

This instruction is only for the advanced user who has experience in programing. Call the function contained inside the external DLLs. Parameters DLL file name Specifies the file name of the DLL. Function name/ordinal Specifies the function name or ordinal number of the function. Retrieve function by ordinal number Specifies how to retrieve the address of the function. Function arguments Specifies the arguments list of calling function. Store return value into Specifies a variable for storing the return value of calling the function. Release DLL module after calling Specifies whether to release the DLL after calling. W ith the option unchecked, the DLL module will be released at the end of playback. The arguments in a function call have the below form: <Parameter-type code>:<Parameter value 1>; <Parameter-type code>:<Parameter value 2>; ... <Parameter-type code>:<Parameter value n>; Parametertype Code Integer Long Byte String W String Date Short Code I L B S W D Data Integer Long Byte Text in DBCS Text in Unicode Date and time Description 2 bytes, the hexadecimal notation 0x is supported. 4 bytes, the hexadecimal notation 0x is supported. 1 bytes, the hexadecimal notation 0x is supported. If the character space is included in the text, the text must be quoted by the single or double quotation marks. In this case, the quotation marks could be represented by \' or \".

16 bytes (same as SY STEMTIME in W indows API), the content should be quoted by the number sign '#'.

Pointer

4 bytes, a pointer to the buffer of a variable. The content must be a variable name. You can use the instruction "Advanced Set Pointer Variable Value" to pre-allocate the memory for the variable, or use the instruction to fill the variable by a structural data.

Example A: Integer:10; Long:200; Date:#2007-09-20#; Pointer:v_size; Example B:(using short code form) S:Hello; L:0x200; S:"Jack Lee";

[email protected]

123 / 213

Help for Macro Expert


Send a Message T o Window

Send Message to Window

This instruction is only for the advanced user who has experience in programing. Sends the specified message to a window or windows. Parameters Send type Specifies how to send the message, it could be the following. Post Message Posts the message and returns immediately. Send Message Sends the message to the window, it will wait for until the window procedure has processed the message or the time is out. T imeout Specifies the duration, in milliseconds, of the time-out period. The zero indicates the time-out interval never elapses. Message Specifies the message that should be sended to the window procedure. Return the result into Specifies the variable to receive the result of the process the message. Parameter type Specifies how to pass the parameter to the message procedure. Parameter value Specifies a value or a variable name. Which window Specifies the window that receives the message. Notes: For more information about specifying a window, please refer to "Specify a W indow".

[email protected]

124 / 213

Help for Macro Expert


Get T ext from Object

Get Text from Object

Extracts the text from the specified UI object (user interface object, such as button, menu item, link and etc.). You could use the instruction to retrieve the content in a text box, the caption of a menu item. Parameters How to get text Specifies how to gather the text. If the "Auto-Detect" is selected, Macro Player will compare the content in the name property of the UI object and the content in the value property, and then return the longer one. Populate variable with readed content Specifies a variable to which stores the readed content. Notes: For more information about locating a UI object, please refer to "Find a UI object".

[email protected]

125 / 213

Help for Macro Expert


Get T ext from Point Extracts the text of the UI object that contains the specified point. Parameters

Get Text from Point

position is relative to Specifies how to calculate the value of the location coordinates, it can be one of the following: Relative to the screen coordinates Absolute coordinates, start from the top-left of the screen.

Relative to the foreground window Relative coordinates, start from the top-left of the foreground window.

Relative to the current position Relative coordinates, start from the position of the current mouse pointer.

Position X Specifies the value of X coordinate. Position Y Specifies the value of Y coordinate. T ext from Specifies how to gather the text. If the "Auto-Detect" is selected, Macro Player will compare the content in the name property of the UI object and the content in the value property, and then return the longer one. Populate variable with result Specifies a variable to hold the result Note: Some applications use picture or other self-draw controls that may act like standard windows controls but dot support the interfaces required to communicate with them. This action will not work with these controls (UI objects). For more information about the tab "W hich W indow", please refer to "Locate a window".

[email protected]

126 / 213

Help for Macro Expert


Generate random number Generate a random number and store it into the variable for using later. Parameters Range Specifies the number which should be within the range.

Generate Random Number

Allow new number to be same as last one Specifies whether to generate a different number to the last. Store number into variable Specifies the variable's name which should be populated with the number. Notes: If the maximum number same as or less than the minimum number, the same number will be generated every time.

[email protected]

127 / 213

Help for Macro Expert


Carry out action on Object

Carry out Action on Object

Performans an action on a UI object (user interface object, such as the button, menu item, link and etc.). Parameters Carry out action Specifies the action, it can be the following: Set focus Sets the focus to the object. Performs object's default action Carries out the default action of the object. Not all objects have a default action Add object to the current selection Adds the object to the current selection. Not all objects support this operation. Remove object to the current selection Removes the object to the current selection. Not all objects support this operation. Notes: For more information about locating a UI object, please refer to "Find a UI object".

[email protected]

128 / 213

Help for Macro Expert


Logoff and Lock workstation Logoff Shuts down all running applications, then it logs the current user off. Lock workstation

Lock workstation

Attempts to lock the workstation's display to protect it from unauthorized use. Notes: Lock workstation is valid only W indows 2000 and later.

[email protected]

129 / 213

Help for Macro Expert


Start out the Screen-Saver Executes the screen saver application. Notes: If there is no screen saver set, the instruction will be ignored.

Start Screen-Saver

[email protected]

130 / 213

Help for Macro Expert


Shut down the computer Shut down Shuts down all running applications, then it shuts the computer down. Restart Shuts down all running applications, then it restarts the computer. Suspend

Shut down computer

Attempts the computer to enter the sleep state. This action depends on the computer hardware, if the hardware doesn't support this mode, the action will be ignored. Hibernate Attempts the computer to hibernate. This action depends on the computer hardware, if the hardware doesn't support this mode, the action will be ignored. NOTE: This action is valid only under W indows 2000 or later. Forces to carry out action without notifing applications If this option is unchecked, shutting down or restarting computer will take place after all running applications are closed, if one of these applications failed to close, shutting down or restarting aborts. If this option is checked, shutting down or restarting computer will take place immediately regardless of whether all running applications are closed, it may cause some applications to lose data.

[email protected]

131 / 213

Help for Macro Expert


T urn on/off Monitor Soft off/on the monitor. T urn off monitor Shuts off the monitor. T urn on monitor Activates the monitor.

Turn off/on Display

[email protected]

132 / 213

Help for Macro Expert


Copy, Cut, Paste and Clear Copy, Cut and Paste

Copy, Cut, Paste and Clear

Simulates the Copy, Cut and Paste operation in the current active application. If the application does not support the clipboard, it will not take effect. Clear Deletes the contents of the clipboard.

[email protected]

133 / 213

Help for Macro Expert


Put a text to the clipboard Stores a text to the clipboard. Parameters

Put a text to the clipboard

Put text to clipboard Specifies a string to which stores into the clipboard. Notes: The size length of text should not be exceed 32000.

[email protected]

134 / 213

Help for Macro Expert


Get the text from clipboard Copy the current content of the clipboard into a variable. Parameters

Get the text from the clipboard

Store text into Specifies a variable to which stores the current contents of the clipboard.

[email protected]

135 / 213

Help for Macro Expert


Play an audio Play a sound or a music file. Parameters T he audio file Specifies a file that you'd like to play.

Play an audio

Wait until the audio completes playback If this option is checked, it will pause the execution of macro until the audio playing is completed, and otherwise, it will execute subsequent actions immediately. Notes: The playing is based on W indows Media Player 6.4 or above.

[email protected]

136 / 213

Help for Macro Expert


Increase/Decrease volume Increases or decreases the volume by a step value. Parameters Device Specifies a device that you'd like to adjust. Notes: The device name for W indows Vista or later can only be "Master". The step value is 10%.

Increase/Decrease Volume

[email protected]

137 / 213

Help for Macro Expert


Adjust volume Adjusts the volume of specified sound device on the computer. Parameters

Adjust volume

Device Specifies a device that you'd like to adjust. It can only be "Master" for W indows Vista or later. Volume Drags the slider right to increase the volume, or left to decrease the volume.

[email protected]

138 / 213

Help for Macro Expert


Sound Switch Turn on the sound if it is mute, otherwise, turn it off. Parameters

Sound Switch

Device Specifies a device that you'd like to turn on or turn off. It can only be "Master" for W indows Vista or later.

[email protected]

139 / 213

Help for Macro Expert


Sound On/Off Specifies whether the sound device is muted or not. Parameters

Sound on/off

Device Specifies a device that you'd like to turn on or turn off. It can only be "Master" for W indows Vista or later.

[email protected]

140 / 213

Help for Macro Expert


CD Player Controls the CD drive on the computer. It is valid only for audio CD. Parameters CD Driver Specifies a driver that you wish to control. Action Specifies an action you want to perform on the CD, it can be one of the following. Play Pause Resume Stop Skip next track Skip previous track Open the door of CD Close the door of CD Notes: As usual, T he default CD driver is the first CD driver.

CD Player

[email protected]

141 / 213

Help for Macro Expert


On Popup Window on Webpage

On Popup Window on Webpage

Specifies how to deal with the popup window in webpage. Some webpage actions (such as "Click", "submit form" and so on) may pop out a window which contains the message, or prompts user for some stuff. This may cause the execution of script to stop until the user clicks a button on the window. Using this action you have the player to click a button automatically. It can also automatically fill the popup window with the predefined text, which is very useful to deal with the file button on the page. Parameters T his rule just applies to Specifies which popup window this rule will apply for. About the window index number, please see the note below. When window pops out Specifies which button should be clicked automatically. It can be the one of following: Do nothing Select first button Select second button Select third button Select button based on the message in dialog Before carrying out action, wait for Specifies the time interval for which execution is to be delay. Automatically place text into text field Specifies the text to be used to fill the text box in the popup window. The multiple text should be separatred by the \0, for example: username\0password. It's only available during performing a webpage action W ith this option checked, this rule only applies for the windows which pop up during executing a webpage action. Reset counter of popup window W ith this option checked, the global popup window counter will be reset, the index number value will start from 1 again when a popup window appears. Notes: The window counter maintains the index number of popup windows, and it's value increments each time the popup window appears. Macro Player has two popup window counters, the global counter and local counter. The global counter always avaiable and increments for every popup window on the webpage. The local counter starts when executes a webpage action, and stops after completing the action. If the option "It's only available during performing a webpage action" checked, does mean that rule is for the local counter only. The instruction can only work for the script popup window but the inner-window which is implement by the div style or other skills.

[email protected]

142 / 213

Help for Macro Expert


Open a Web page Opens the specified web page in the default browser. Parameters

Open a Web page

T he Address(URL) Specifies the web page or URL that should be opened. The web page will be opened in the default browser. Open method Specifies how to open the URL, it can be general, open in new window or open in new tab. After opening Specifies whether to wait the content of page to complete downloading. Page name Specifies a name to the webpage, the name will be used in the webpage related actions to distinguish among several webpages. Don't close connected page before opening If the target page name has been used and connected to a webpage, specifies whether to close the connected page before opening. Open it in Microsoft Internet Explorer Specifies whether to open it in Microsoft Internet Explorer or the internal browserzs. Generally, the internal browser will give more performance. Close page at end of playback Specifies whether to automatically close the opened page when the playback complete. Return URL into variable Specifies a variable to hold the actual URL after the page opened. Notes: A script window may cause that player wait until user responds it. To click the button automatically in the script window, insert an action "On Popup W indow on Webpage" before the action. The address can be any URL that is valid to the current browser. For more information about timeout, please refer to "Timeout".

[email protected]

143 / 213

Help for Macro Expert


Connect a Opened Webpage

Connect a Opened Webpage

Connects a opened webpage. This is required if you'd like to perform some actions(filling page form or navigating on the webpage) on the webpage. The instruction will also be used to connect the webpage opened in the parent task. Parameters Find method Specifies how to search the webpage. Find content Specifies the title or URL to search. Page name in parent task For the option "Connect to webpage in parent task" only, specifies the page name in the parent task. Match case Specifies whether the search is case-sensitive. Match whole word Specifies whether to search only for whole words that match the search content. Close page at end of playback Specifies whether to close the page at the end of playback of the macro. Close page before connecting Specifies whether to close the page before connecting another one using the same page name. After connecting Specifies whether to wait the content of page to complete downloading. Page name Specifies a name to the webpage, the page name used to distinguish a webpage among the Webpages. Return URL into variable Specifies the name of the variable to which stores the URL of the page.

[email protected]

144 / 213

Help for Macro Expert


Close a Opened Webpage

Close Webpage

Close a opened Webpage, the webpage may be opened by the action "Open a Webpage" or "Connect a Opened Webpage". If the webpage is opened in the parent task, this instruction will terminate the connection without closing the webpage. Parameters Page name Specifies the name of the webpage. Quit Internet Explorer Specifies whether to quit Internet Explorer instance when closing the page. The option "Quit Internet Explorer" will be ignored if the webpage is not opened by Internet Explorer. Notes: An error will throw if the specified webpage is not connected or opened when executing the action.

[email protected]

145 / 213

Help for Macro Expert


Read Field on Webpage Reads a field's value on webpage. Parameters Page name Specifies which page will be read. The webpage should be opened or connected before executing this action. Locate element by its path in page Specifies the element path in the page. For example: HTML.HEAD.TITLE Locate element by its attributes Element type must be Specifies the type of the element. Name must be Specifies the element name. Display text must be Specifies the display text for the the element. URL must be The option is for the hyperlink element.

Read Field

Index of elements that match criteria Specifies the position of matched elements collection when more than one elements meet the criteria. Searching in main frame Specifies whether to search for the element in the main frame in the webpage. Frame name must be Specifies the frame name if searching for the element in a specified frame. Index of frames that match criteria If more than one frames have the same name, specifies the index of the frames collection. Form name must be Specifies the form name if searching for the element in a specified form. Index of forms that match criteria If more than one forms have the same name, specifies the index of the forms collection. Element attributes Specifies an attributes filter for the searching, using the standard HTML syntax, for example: id="abc" name="login" Match case Specifies whether the search is case-sensitive. Match whole word Specifies whether to search only for whole words that match the search content. Only visible element Specifies whether to igonre the hidden elements. Read what Specifies the content to be read, it can be one of the following: Read Read Read Read inner text inner HTML attribute value user typed value

Return read content into variable Specifies a variable for holding the field value. Notes: The webpage should be opened or connected before performing this action.

[email protected]

146 / 213

Help for Macro Expert


Fill a Field in Webpage Fills a field on Webpage. Parameters Page name Specifies which page will be read. The webpage should be opened or connected before executing this action. Locate element by its path in page Specifies the element path in the page. For example: HTML.HEAD.TITLE Locate element by its attributes Element type must be Specifies the type of the element. Name must be Specifies the element name. Display text must be Specifies the display text for the the element. URL must be The option is for the hyperlink element. Index of elements that match criteria Specifies the position of matched elements collection when more than one elements meet the criteria.

Fill Field

Searching in main frame Specifies whether to search for the element in the main frame in the webpage. Frame name must be Specifies the frame name if searching for the element in a specified frame. Index of frames that match criteria If more than one frames have the same name, specifies the index of the frames collection. Form name must be Specifies the form name if searching for the element in a specified form. Index of forms that match criteria If more than one forms have the same name, specifies the index of the forms collection. Element attributes Specifies an attributes filter for the searching, using the standard HTML syntax, for example: id="abc" name="login" Match case Specifies whether the search is case-sensitive. Match whole word Specifies whether to search only for whole words that match the search content. Only visible element Specifies whether to igonre the hidden elements. Field content Specifies the data to be filled in the field. Force to fill value into element W ith the option checked, the player will change the inner text of the element. For some W Y SIW Y G pages, you have to set this option checked to fill the POST area. Because it is not a standard input element in this kind page. Notes: If the element is not a standard input element, you must to use the option "Force to fill value into element". For the checkbox, you can use the number 1 or text true to check it.

[email protected]

147 / 213

Help for Macro Expert


Click Element

Click Element

Searches the webpage for the element that matches the specified criteria, and then simulates a click on it. Parameters Page name Specifies which page will be read. The webpage should be opened or connected before executing this action. Locate element by its path in page Specifies the element path in the page. For example: HTML.BODY.H1(2) Locate element by its attributes Element type must be Specifies the type of the element. Name must be Specifies the element name. Display text must be Specifies the display text for the the element. URL must be The option is for the hyperlink element. Index of elements that match criteria Specifies the position of matched elements collection when more than one elements meet the criteria. Searching in main frame Specifies whether to search for the element in the main frame in the webpage. Frame name must be Specifies the frame name if searching for the element in a specified frame. Index of frames that match criteria If more than one frames have the same name, specifies the index of the frames collection. Form name must be Specifies the form name if searching for the element in a specified form. Index of forms that match criteria If more than one forms have the same name, specifies the index of the forms collection. Element attributes Specifies an attributes filter for the searching, using the standard HTML syntax, for example: id="abc" name="login" Match case Specifies whether the search is case-sensitive. Match whole word Specifies whether to search only for whole words that match the search content. Only visible element Specifies whether to igonre the hidden elements. After clicking Specifies whether to wait the content of page to complete downloading. Return URL into variable Specifies the variable to hold the URL after clicking. Notes: For more information about timeout, please refer to "Timeout".

[email protected]

148 / 213

Help for Macro Expert


Find Element on a Webpage

Find Element

Searches the webpage for the element that matches the specified criteria. You can also use this action to gather the display text of the element. Parameters Page name Specifies which page will be read. The webpage should be opened or connected before executing this action. Locate element by its path in page Specifies the element path in the page. For example: HTML.HEAD.TITLE Locate element by its attributes Element type must be Specifies the type of the element. Name must be Specifies the element name. Display text must be Specifies the display text for the the element. URL must be The option is for the hyperlink element. Index of elements that match criteria Specifies the position of matched elements collection when more than one elements meet the criteria. Searching in main frame Specifies whether to search for the element in the main frame in the webpage. Frame name must be Specifies the frame name if searching for the element in a specified frame. Index of frames that match criteria If more than one frames have the same name, specifies the index of the frames collection. Form name must be Specifies the form name if searching for the element in a specified form. Index of forms that match criteria If more than one forms have the same name, specifies the index of the forms collection. Element attributes Specifies an attributes filter for the searching, using the standard HTML syntax, for example: id="abc" name="login" Match case Specifies whether the search is case-sensitive. Match whole word Specifies whether to search only for whole words that match the search content. Only visible element Specifies whether to igonre the hidden elements. Populate variable with result Specifies the name of the variable to which stores the result (the number 1 or 0). Set keyboard focus to element Specifies whether to set the cursor focus to the element. Read what Specifies the content to be read, it can be one of the following: Don't read content Read inner text Read inner HTML Read attribute value Read user typed value Notes:

[email protected]

149 / 213

Help for Macro Expert

Find Element

If an element matches the criteria, the value of the global variable "error" will be a string "OK", otherwise, it will be set to the string "WAR".

[email protected]

150 / 213

Help for Macro Expert


Submit a Form on Webpage Simulates a submission on Webpage. Parameters

Submit Form

Page name Specifies which page will be read. The webpage should be opened or connected before executing this action. Which form Specifies how to locate the target form, it can be one of the folowing: Locate form by name Locate form by ID Locate form by attributies Form name Specifies the form name, if the target form is a noname form, leaves the field blank, and uses the option Index of forms that match criteria. Form ID Specifies the ID of the form, if the target form does not have ID, leaves the field blank, and uses the option Index of forms that match criteria. Form attributes Specifies the attributes string for searching the form, it must fit the specification of HTML. For example : id="abc" method="get" Index of forms that match criteria Specifies the index number of the forms collection if there are more than one forms match the searching criteria. After submitting Specifies whether to wait the content of page to complete downloading. Return URL into variable Specifies the variable to hold the URL after submitting. Notes: For more information about the timeout, please refer to "Timeout".

[email protected]

151 / 213

Help for Macro Expert


Save webpage content

Save webpage content

Stores the content in the web page into a variable or local file. You may use this action and "Find Text" to extract particular data from the web. Parameters Page name Specifies which page will be read. The webpage should be opened or connected before executing this action. Save to local file (optional) Specifies a filename to save the content in. Populate variable with page content (optional) Specifies a variable to save the content in. Save HT ML source W ith the option unchecked, the text show in browser will be saved. Save content of main frame Specifies to save the content in the main frame, and if the page contains frames, the content in the frames will be ignored. Save content of a frame Specifies to save the content of a frame in the page. Save all frames W ith this option selected, all content in the page will be saved, includes the all inner frames. Note: W hen saving all frames, and the option "Save HT ML source" is checked, every frame will store into the separated file, and excepts the file of the main frame, the other files' name will be added a sort number , file_0, file_1, file_2 and etc..

[email protected]

152 / 213

Help for Macro Expert


Save Image Element

Save Image Element

Locates an image element in the webpage and saves it into a file, the action can also save the image binary data into the variable. Parameters Page name Specifies which page will be read. The webpage should be opened or connected before executing this action. Locate element by its path in page Specifies the element path in the page. For example: HTML.BODY.H1(2) Locate element by its attributes Element type must be Specifies the type of the element. Name must be Specifies the element name. Display text must be Specifies the display text for the the element. URL must be The option is for the hyperlink element. Index of elements that match criteria Specifies the position of matched elements collection when more than one elements meet the criteria. Searching in main frame Specifies whether to search for the element in the main frame in the webpage. Frame name must be Specifies the frame name if searching for the element in a specified frame. Index of frames that match criteria If more than one frames have the same name, specifies the index of the frames collection. Form name must be Specifies the form name if searching for the element in a specified form. Index of forms that match criteria If more than one forms have the same name, specifies the index of the forms collection. Element attributes Specifies an attributes filter for the searching, using the standard HTML syntax, for example: id="abc" name="login" Match case Specifies whether the search is case-sensitive. Match whole word Specifies whether to search only for whole words that match the search content. Only visible element Specifies whether to igonre the hidden elements. Image format Specifies the image data format, it can be BMP, JPG, GIF, or GIF. Save to file Optionally, specifies the file path name for saving the image data. If file exists Specifies how this action is to processed if a file of the same name as the specified by the field Save to file already exists. It can be "Don't save", "Overwrite existing file", "Save with an unique filename". W ith the option "Save with an unique filename", the new file will be renamed as "abc01.bmp", "abc02.bmp" and so on. Save image data into variable Optionally, specifies a variable for holding the image data, in the binary format.

[email protected]

153 / 213

Help for Macro Expert


Navigation Action on Webpage Performs an action on a Webpage. Parameters

Internet Explorer Navigation Actions

Page name Specifies the webpage name, it will determine which page the action applies on. Action T ype Specifies the action type, it can be one of the following: Goto Refresh Go back Forward Go homepage Stop Open a URL Specifies how to deal with the URL, it can be opened in a new window, a new tab. After carrying out Specifies whether to wait the content of page to complete downloading. Return URL into variable Specifies the variable to hold the new URL if the page's URL changed after performing the action. Notes: For more information about timeout, please refer to "Timeout".

[email protected]

154 / 213

Help for Macro Expert


Send Email Sends an email via SMTP protocol. Parameters

Send Email

T o Specifies the recipient. Multiple recipients should be separated by the semi-colon character. From Specifies the sender. Subject Specifies the subject of the email. T ext body Specifies the email content. Body from a file Specifies that the content of the message should be filled by a specified file. Is HT ML Specifies that the content of the message is HTML formatted. Return receipt Specifies whether to ask a return receipt from the recipient. CC Specifies addresses that the message should be sent "carbon-copies" to. BCC Specifies addresses that the message should be sent "blind-carbon-copies" to. Attachments Specifies files that should be sent to the recipient. Note: For more information about the mail server options, please refer to "Mail Server". For more information about the proxy options, please refer to "Proxy". For more information about the timeout options, please refer to "Timeout".

[email protected]

155 / 213

Help for Macro Expert


HT T P Download Downloads a file from the specified URL via the HTTP protocol. Parameters URL specifies the URL to begin reading. Local file Specifies a full-path name that the downloaded file stores to.

HTTP Download

If file name exists Specifies how to store the file if the file name has been used by another file. It can be one of the following: Don't save Overwrite existing file Save with a unique file name Authencation information Specifies the user name and password if authentication is required for accessing the URL. Store content into Specifies a varialbe that populates with the downloaded data. Store type Specifies how to save the data for the variable, it can be the binary format or text format. Note: For more information about the proxy options, please refer to "Proxy". For more information about the timeout options, please refer to "Timeout".

[email protected]

156 / 213

Help for Macro Expert


Ping Sends a series of packets over a network or the Internet to a specific computer in order to generate a response from that computer. The action may also retrieve the IP address of the target computer. Parameters IP address or host name Specifies the target host. Number of echo requests Specifies the number of echo requests to send. T ime interval of each request Specifies the time interval of sending, in milliseconds. Return average relay time into Specifies a variable for storing the relay time, in milliseconds. Return IP address into (optional) Specifies a variable for storing the IP address of the target computer. Return packet-loss rate into (optional) Specifies a variable for storing the packet-loss rate. Note: If the target host does not allow ICMP echo request, the ping will return nothing.

Ping

[email protected]

157 / 213

Help for Macro Expert


Retrieve Internet T ime Retrieves the time value from a remote host, and set the local time. Parameters T ime server Specifies the remote host which is running the SNTP.

Retrieve Internet Time

Set system clock to internet time Specifies whether to set the local system time. Populate variable with time value Specifies a variable for storing the received time value. Note: For time-out options, please refer to "Time out".

[email protected]

158 / 213

Help for Macro Expert


Internet Explorer Actions Clear Internet Explorer History

Clear Internet Explorer History

Remove all shortcuts to the pages you viewed during this and previous browsing sessions under Internet Explorer. Delete Internet Explorer Cookies Remove all the cookies file on your computer. A cookie is a file created by a Web site that stores information on your computer, such as your perferences when visiting that site. Delete T emporary Internet Files Remove all contents of the Temporary Internet Files folder or folders.

[email protected]

159 / 213

Help for Macro Expert


Make remote access connection Establishes a remote access connection by dialing up. Parameters

Make remote access connection

Dial-up entry Specifies the name of the entry that you want to connect. Use default dial parameters to connect If this option is checked, the Phone number, User name and Password will be ignored. Phone number Specifies the phone number for dialing, if it is a no-dial entry(such as ADSL), leave this field empty. User name Specifies the user name to use when logging on to the remote connection. Password Specifies the password to use when logging on to the remote connection. If connection fails then redial Specifies how many times that should be redialed, if connection fails. Notes: The amount of waiting time is 3 seconds before attempting redialing.

[email protected]

160 / 213

Help for Macro Expert


Disconnect remote access connection Terminates a remote access connection. Parameters

Disconnect remote access connection

Disconnect Specifies the name of the entry that you wish to terminate. Notes: If the entry does not exist when the action is executing, the action will fail. The entry name can be an expression.

[email protected]

161 / 213

Help for Macro Expert


Connect network resource

Connect network resource

Makes a connection to a network resource. The action can redirect a local device to the network resource. Parameters Network resource Specifies the network resource to connect to. For example: \\192.168.0.1\e Use local device name Specifies whether to redirect the network connection to the local device. Return local name into Specifies a variable for storing the local device name when the connection is ok. User name/password Specifies the user name and password for making the connection. You may left the fields blank for using default user name. Interact with user if failed to authorize Specifies whether to show the dialog for authorization purpose when connecting the network connection is failed Network resource should be remembered Specifies whether to remember the network connection. W ith the option checked, the operating system automatically attempts to restore the connection when the user logs on. Note: For more information about the file and printer sharing, please refer to "W indows Help". For more information about the variable, please refer to "Variable and Expression".

[email protected]

162 / 213

Help for Macro Expert


Disconnect network resource

Disonnect network resource

Cancels an existing W indows network connection. You can also use the action to remove remembered network connections that are not currently connected. Parameters Local device name Specifies the name of either the redirected local device or the remote network resource to disconnect from. Force to disconnect Specifies whether the disconnection should occur if there are open files or jobs on the connection. Network resource should be remembered The W indows will not restore this connection during subsequent logon operations. (Disconnecting resources using remote names has no effect on persistent connections.) Note: More information about the file and printer sharing, please refer to "W indows Help".

[email protected]

163 / 213

Help for Macro Expert

Copy files

Copy Files Copy one or more existing files to a folder. Parameters Source Specifies a full-qualified path and filename. The standard Microsoft MS-DOS wild cards are permitted in the file-name position. Multiple file names may be specified by separating entries with a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will have unpredictable results, if you use the relative paths. Exclude mask Specifies one or more source file names which don't copy at this operation. Also, each file name must be terminated by a single semicolon, and standard Microsoft MS-DOS wild cards, such as "*", are permitted in the file-name position. The wild cards name "*.*" does not allowed. Match case Specifies whether the search finds the source files which names match the case of characters in the Files or folder name exactly. Include subfolders Specifies whether the search extends to the subfolders of the Source folder. Destination folder Specifies a full-qualified name of the destination folder. This parameter must be not empty and wild cards are not permitted in the name position. It will have unpredictable results, if you use the relative paths. Create destination folder if it does not exist Specifies whether to attempt to create the destination folder if the folder does not exist. If the option is unchecked and the destination folder is not existed either, the action will not be started. Overwrite if destination file exists Specifies whether to overwrite the destination file when it does exist in the destination folder. Keep subfolders structure Specifies whether to create the subfolder under the destination folder. If this option is unchecked, all of the source files will be copied into the destination folder and it is possible to occur several files with the same name. As a result these files will be renamed by adding a number at the end of its name for distinguishinging. e.g. abc.txt, abc01.txt, abc02.txt. Note: You could filter files based on the attribute settings of the source files. For more information, please refer to Attributes Filter. To exclude certain subfolders, the folder name must be preceded by a backslash character \ in

[email protected]

164 / 213

Help for Macro Expert


the field Exclude mask. For example: \My Pictures;\My Music;.

Copy files

[email protected]

165 / 213

Help for Macro Expert

Move files

Move Files Move one or more existing files to a folder. Parameters Source Specifies a full-qualified path and filename. The standard Microsoft MS-DOS wild cards are permitted in the file-name position. Multiple file names may be specified by separating entries with a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will have unpredictable results, if you use the relative paths. Exclude mask Specifies one or more source file names which don't move at this operation. Also, each file name must be terminated by a single semicolon, and standard Microsoft MS-DOS wild cards, such as "*", are permitted in the file-name position. The wild cards name "*.*" does not allowed. Match case Specifies whether the search finds the source files which names match the case of characters in the Files or folder name exactly. Include subfolders Specifies whether the search extends to the subfolders of the Source folder. Destination folder Specifies a full-qualified name of the destination folder. This parameter must be not empty and wild cards are not permitted in the name position. It will have unpredictable results, if you use the relative paths. Create destination folder if it does not exist Specifies whether to attempt to create the destination folder if the folder does not exist. If the option is unchecked and the destination folder is not existed either, the action will not be started. Overwrite if destination file exists Specifies whether to overwrite the destination file when it does exist in the destination folder. Keep subfolders structure Specifies whether to create the subfolder under the destination folder. If this option is unchecked, all of the source files will be moved into the destination folder and it is possible to occur several files with the same name. As a result these files will be renamed by adding a number at the end of its name for distinguishing. e.g. abc.txt, abc01.txt, abc02.txt. Note: You could filter files based on the attribute settings of the source files. For more information, please refer to Attributes Filter. To exclude certain subfolders, the folder name must be preceded by a backslash character \ in

[email protected]

166 / 213

Help for Macro Expert


the field Exclude mask. For example: \My Pictures;\My Music;.

Move files

[email protected]

167 / 213

Help for Macro Expert

Delete files

Delete Files Delete one or more existing files. Parameters Source Specifies a full-qualified path and filename. The standard Microsoft MS-DOS wild cards are permitted in the file-name position. Multiple file names may be specified by separating entries with a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will have unpredictable results, if you use the relative paths. Exclude mask Specifies one or more source file names which don't copy at this operation. Also, each file name must be terminated by a single semicolon, and standard Microsoft MS-DOS wild cards, such as "*", are permitted in the file-name position. The wild cards name "*.*" does not allowed. Match case Specifies whether the search finds the source files which names match the case of characters in the Files or folder name exactly. Include subfolders Specifies whether the search extends to the subfolders of the Source folder. Delete empty subfolder Specifies whether to delete the empty subfolder, if this option is selected, a subfolder will be deleted if it does not contains any files. Put into Recycle Bin W ith this option selected, if possible, the files will be put into the Recycle Bin until you decide to permanently delete them. Note: You could filter files based on the attribute settings of the source files. For more information, please refer to Attributes Filter. To exclude certain subfolders, the folder name must be preceded by a backslash character \ in the field Exclude mask. For example: \My Pictures;\My Music;.

[email protected]

168 / 213

Help for Macro Expert

Create a folder

Create a folder Create a new folder with default security attributes. Parameters Folder Specifies a full-qualified path that contains the name of the directory to be created. Relative path is not permitted. Retrieve path of new folder Assign the path of the new folder to a variable for subsequent using. The variable can be empty. Notes: You may specify a multi-level folder to create, such as "c:\abc\abc\abc".

[email protected]

169 / 213

Help for Macro Expert

Delete a folder

Delete a folder Delete an existing folder. Parameters Folder A full-qualified path contains the folder which need to removed. It will have unpredictable results, if you use the relative paths. If folder is not empty Remove all subfolders and files W ith this option, all subfolders and files underlying the folder will be deleted. Don't remove the folder. W ith this option, the delete operation will be performed only if the destination folder is empty. Put into Recycle Bin W ith this option selected, if possible, the files will be put into the Recycle Bin until you decide to permanently delete them.

[email protected]

170 / 213

Help for Macro Expert

Rename files

Rename files or folders Rename one or more existing files or folders. The format control tags are supported. Parameters Source Specifies a full-qualified path and filename. The standard Microsoft MS-DOS wild cards are permitted in the file-name position. Multiple file names may be specified by separating entries with a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will have unpredictable results, if you use the relative paths. Exclude mask Specifies one or more source file names which don't move at this operation. Also, each file name must be terminated by a single semicolon, and standard Microsoft MS-DOS wild cards, such as "*", are permitted in the file-name position. The wild cards name "*.*" does not allowed. Match case Specifies whether the search finds the source files which names match the case of characters in the Files or folder name exactly. Include subfolders Specifies whether the search extends to the subfolders of the Source folder. Destination name(Format-control string) Specifies the new name for the file or folder, the format control tags can be placed in the name position, for more information about the format control tag, please see the remark. If destination name has been used Specifies the action when the destination name has been used by another file or folder, it can be: Ignore, don't try to rename the file Add a number at end of file name Allow to rename folder Specifies whether to rename the folder. Sequence number for all sub-folder(s) Specifies how to use the sequence number. W ith the option checked, all files use one index number, it makes sure that the name of the file is uniquely under the specified folder, no matter where it is. Remark: The destination name can contains one or more format control tags which are special codes used to generate an actual file name. A tag consists of a left angle bracket <, a type character, and a right angle bracket >. For example, to get source file name you may insert the tag "<s>" in the destination name parameter. The type character such as the "s" in the <s> is case

[email protected]

171 / 213

Help for Macro Expert

Rename files

sensitive. Therefore, the "<m>" and "<M>" will do different the thing - "<m>" get the month of the current date, and "<M>" get the minute of the current time. Notes The file main name and extension name will be handled respectively. For example, a file name "hello.txt" and the destination name control string is "<s>", a new name "hello" will be generated, if you want to get a full name, the destination name control string should be "<s>.&lts>". The following table is the tags that are permitted in the destination name. T ag <s> <sl> <su> <lx> <llx> <lux> <rx> <rlx> <rux> <ix,n> <ilx,n> Original file name. Original file name in lowercase Original file name in uppercase Get left x characters from the original name Get left x characters from the original name in lowercase. Get left x characters from the original name in uppercase Get right x characters from the original name Get right x characters from the original name in lowercase Get right x characters from the original name in uppercase Get a substring from the orginal name n characters from the original name, starting at position x (zero-based). In lowercase, get a substring from the orginal name n characters from the original name, starting at position x (zerobased). In uppercase, Get a substring from the orginal name n characters from the original name, starting at position x (zerobased). In above i tags, the ,n can be omitted to represent the remainder of the string. <n> <n?x> The index number of the source file in the searching. The index number of the source file in the searching, with prefix characters. The prefix characters will be added until the minimum width x is reached. For example, the index number is 20 and the format control string of the destination name is "<nA5>"(i.e. the prefix character is 'A' and the width is "5".), a new name "AAA20" is generated. The current time The current date Year of the current date Month of the current date Day of the current date Hour of the current time Minute of the current time Second of the current time Description

<iux,n>

<T > <D> <y> <m> <d> <h> <M> <e> Example

The original file name : "MacroExpert.txt"

[email protected]

172 / 213

Help for Macro Expert


The current date and time : "08/05/2005 01:00" Destination name control Generated new name string abc.txt <s>.<s> <sl>.<sl> <su>.<su> abc-<su>.<su> <l5>.<l3> pic<lu5>.<lu3> pic-<rl5>.jpg pic-<n03>.jpg pic-<ll5><n-3>.jpg pic-<D>.<s> <l5>---<i5>.<s> <l5>---<i5,2>.<s> Note: abc.txt MacroExpert.txt macroexpert.txt MACROEXPERT.TXT abc-MACROEXPERT.TXT Macro.txt picMACRO.TXT pic-xpert.jpg pic-001.jpg pic-macro--1.jpg pic-08-05-2005.txt Macro---Expert.txt Macro---Ex.txt

Rename files

You could filter files based on the attribute settings of the source files. For more information, please refer to Attributes Filter. To exclude certain subfolders, the folder name must be preceded by a backslash character \ in the field Exclude mask. For example: \My Pictures;\My Music;.

[email protected]

173 / 213

Help for Macro Expert

Set file attributes

Set files attributes Change the attributes of the one or more existing files or folders. Parameters Source Specifies a full-qualified path and filename. The standard Microsoft MS-DOS wild cards are permitted in the file-name position. Multiple file names may be specified by separating entries with a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will have unpredictable results, if you use the relative paths. Exclude mask Specifies one or more source file names which don't move at this operation. Also, each file name must be terminated by a single semicolon, and standard Microsoft MS-DOS wild cards, such as "*", are permitted in the file-name position. The wild cards name "*.*" does not allowed. Match case Specifies whether the search finds the source files which names match the case of characters in the Files or folder name exactly. Include subfolders Specifies whether the search extends to the subfolders of the Source folder. Archive attribute Specifies whether the file or folder should be archived. Hidden attribute Specifies whether the file or folder is hidden. Read-only attribute Specifies whether the file or folder is read-only. System attribute Specifies whether the file or folder is a system file or folder. Allow to set folder's attribute Specifies whether to change the attribute of the folder. Notes: For more information about the file attributes, please refer to W indows Help. Note: You could filter files based on the attribute settings of the source files. For more information, please refer to Attributes Filter.

[email protected]

174 / 213

Help for Macro Expert

Set file attributes

To exclude certain subfolders, the folder name must be preceded by a backslash character \ in the field Exclude mask. For example: \My Pictures;\My Music;.

[email protected]

175 / 213

Help for Macro Expert

Change file time

Change file(s) date and time Change the time of one or more existing files or folders, include created time, last modified time. Parameters Source Specifies a full-qualified path and filename. The standard Microsoft MS-DOS wild cards are permitted in the file-name position. Multiple file names may be specified by separating entries with a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will have unpredictable results, if you use the relative paths. Exclude mask Specifies one or more source file names which don't move at this operation. Also, each file name must be terminated by a single semicolon, and standard Microsoft MS-DOS wild cards, such as "*", are permitted in the file-name position. The wild cards name "*.*" does not allowed. Match case Specifies whether the search finds the source files which names match the case of characters in the Files or folder name exactly. Include subfolders Specifies whether the search extends to the subfolders of the Source folder. Modify time that the file was created W ith this option selected, a new time can be set on the file or folder. If the option is unchecked, the time will not be modified. Modify time that the file was last modified A new modified time can be set on the file or folder. If the option is unchecked, the time will not be modified. T ips: If you'd like to change the time only, you may specify a time string to the parameter, also, you may specify a date string to the parameters to if you'd like to change the date only. Notes: The time parameter can take a variety of formats. For example, the following strings contain acceptable date/time formats: "25 January 1996" "8:30:00" "20:30:00" "January 25, 1996 8:30:00" "8:30:00 Jan. 25, 1996" "1/25/1996 8:30:00" Please note that always specifies the full year.

[email protected]

176 / 213

Help for Macro Expert


Note:

Change file time

You could filter files based on the attribute settings of the source files. For more information, please refer to Attributes Filter. To exclude certain subfolders, the folder name must be preceded by a backslash character \ in the field Exclude mask. For example: \My Pictures;\My Music;.

[email protected]

177 / 213

Help for Macro Expert

Synchronize Folders

Synchronize Folders Synchronizes files between two folders which may be separated in two drivers or even in two computers. You may use the instruction to synchronize documentation between a local hard driver and a removable driver, or between a local hard driver and a remote network driver. You also utilize the instruction to remove unwanted files from the destination folder according to a specified folder. Parameters Source Specifies a full-qualified path and filename. The standard Microsoft MS-DOS wild cards are permitted in the file-name position. Multiple file names may be specified by separating entries with a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will have unpredictable results, if you use the relative paths. Exclude mask Specifies one or more source file names which don't synchronize at this operation. Also, each file name must be terminated by a single semicolon, and standard Microsoft MS-DOS wild cards, such as "*", are permitted in the file-name position. The wild cards name "*.*" does not allowed. Match case Specifies whether the search finds the source files which names match the case of characters in the Files or folder name exactly. Include subfolders Specifies whether the search extends to the subfolders of the Source folder. Destination folder Specifies a full-qualified name of the destination folder. This parameter must be not empty and wild cards are not permitted in the name position. It will have the unpredictable result, if you use relative paths. Create destination folder if it does not exist Determine whether to create the destination folder if it does not exist before synchronizing. This option is not available when using Difference Synchronization. Unbirdirection W ith this method of synchronization, the latest version files in the source folder will be copied into destination folder. Birdirection W ith this method of synchronization, the latest version files in the source folder will be copied into destination folder, and the latest version files in the destination folder will be copied into source folder too. Difference synchronization The synchronization will remove unwanted files in the destination folder. All the files which do

[email protected]

178 / 213

Help for Macro Expert


exist in the destination folder but do not in the source folder will be removed. Note:

Synchronize Folders

You could filter files based on the attribute settings of the source files. For more information, please refer to Attributes Filter. To exclude certain subfolders, the folder name must be preceded by a backslash character \ in the field Exclude mask. For example: \My Pictures;\My Music;.

[email protected]

179 / 213

Help for Macro Expert

Compress files

Compress Files Compresss the files into a zip file. You may utilize the instruction to backup your documentation, music, picture and other archives. Parameters Source Specifies a full-qualified path and filename. The standard Microsoft MS-DOS wild cards are permitted in the file-name position. Multiple file names may be specified by separating entries with a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will have unpredictable results, if you use the relative paths. Exclude mask Specifies one or more source file names which don't compress at this operation. Also, each file name must be terminated by a single semicolon, and standard Microsoft MS-DOS wild cards, such as "*", are permitted in the file-name position. The wild cards name "*.*" does not allowed. Match case Specifies whether the search finds the source files which names match the case of characters in the Files or folder name exactly. Include subfolders Specifies whether the search extends to the subfolders of the Files or folder name. Zip filename Specifies a full-qualified name of the destination zip file. Action Determines the method of compress, it may be: Add or replace the files Addes all files into the archive. Freshen existing files Updates files already in the zip file. Move files Addes all files into the archive and remove the files from the disk. Update or add files If the file already in the zip file, it will be update, otherwise, it will be added into the zip file. Compression Determines the level of compression. Specifies how to compress the files, the faster options usually result in larger zip file. Save full path info Specifies whether to save the full folder information in the zip file. Store filenames in 8.3 format

[email protected]

180 / 213

Help for Macro Expert

Compress files

Specifies whether to convert the long file name into 8.3 DOS style. If the zip file will be used in the older operation system which does not support long filename, you may check the option. Note: You could filter files based on the attribute settings of the source files. For more information, please refer to Attributes Filter To exclude certain subfolders, the folder name must be preceded by a backslash character \ in the field Exclude mask. For example: \My Pictures;\My Music;.

[email protected]

181 / 213

Help for Macro Expert

Extract a zipped file

Extract a zip file Extracts the files in a zip file to a specified folder. Parameters Zip filename Specifies a full-qualified name of the zip file. Extract files to Specifies a full-qualified path of the destination folder. Which files Determines which files should be extracted. Each file name must be terminated by a single semicolon, and standard Microsoft MS-DOS wild cards, such as "*", are permitted in the filename position. Exclude mask Specifies one or more file names which don't extract at this operation. Also, each file name must be terminated by a single semicolon, and standard Microsoft MS-DOS wild cards, such as "*", are permitted in the file-name position. The wild cards name "*.*" does not allowed. Match case Specifies whether the search finds the source files which names match the case of characters in the Which files exactly. Overwrite existing files Specifies whether the existing files should be overwritten. Skip older files Specifies whether to skip the file on the disk which is newer than the file in the zip file. Use folder names Specifies whether to use the path of the file stored in zip file. W ith the option checked, the folder of the file will be created under the destination folder before it is extracted, otherwise, all files will be extracted to the destination folder without creating the sub-folder.

[email protected]

182 / 213

Help for Macro Expert


Read text file Read from a plain-text file. Parameters Source file name Specifies a full-qualified name of the source file.

Read text file

Position for reading Specifies the position of reading. It can be one of the following: Specify the line number Beginning of the file Read all content in the file Store read content into Specifies the variable for storing the read content. Return EOF state into variable Specifies the variable for storing the EOF state. If the reading position exceeds the end of the file, the value is the number 1, otherwise, it is 0. Ignore EOF error Specifies whether to ignore the EOF error. Note: For more information about the variable, please click here

[email protected]

183 / 213

Help for Macro Expert


Write text file Write the content into a plain-text file. Parameters

Write text file

Destination file name Specifies a full-qualified name of the plain-text file(.txt). Position for writing Specifies the position of writing. It can be one of the following: End of the file Beginning of the file Specify the line number Write content Specifies the content for writing. T ext encoding format Specifies the text encoding, it can be one of ANSI, UNICODE and UTF8. Failed if destination file exist Specifies whether to write into a new file. T runcate destination file W ith the option checked, the player will truncate the content of the file from the writing position, then writes the content. Don not write new-line character W ith the option unchecked, the CRLF character will be placed the end of the content automatically. Note: For more information about the variable, please click here

[email protected]

184 / 213

Help for Macro Expert


Replace in File Replaces the content in a plain-text file. Parameters File name Specifies a full-qualified name of the file. Start position Specifies the initial position for finding. Find what Specifies the sub string to search for.

Replace in File

Replace with Specifies the substitution string. To remove the sub string from the variable, left the field blank. Match case Specifies the searching is case-sensitive or not. Replace all Specifies whether to replace the next matched string or replace all matched. Use regular expression Specifies whether to use regular expression. W ith this option unchecked, you may also use wildcards such as asterisks (*) and question marks (?) in search string. Backup original file Specifies whether to backup the ordinal file before saving the chanes. Populate variable with number of substitutions made If the sub string (pattern) is not found, return value is 0. Populate variable with next start position Specifies a variable to hold the next start position, the next start position is calculated by the follow formula: next start position=first occurrence position + size of substitution string Note: For more information about regular expression, you may visit at http://en.wikipedia.org/wiki/Regular_expression.

[email protected]

185 / 213

Help for Macro Expert


Open Document (This action is available in Enterprise Edition only)

Open Document

Opens a document for reading or writing. It is a necessary before accessing the document file. Parameters Path name of document file: Specifies the full path name of the document file. Password to open Specifies the password to open the document, if the document type does not support the open password, the parameters will be ignored. Password to modify Specifies the password to modify the document, if the document type does not support the write-protected password, the parameters will be ignored. Open document for read-only Specifies whether to open the document for read only. Show application when opening document Only for Microsoft Office, after opening the document the program main window will show if the option is checked. Don't close document after playback W ith the option checked, the application will not be closed after playback. Automatically save changes of document before closing it Specifies whether to save the changes before closing the document. The option is applied to the situation that there is no "Close Document" action after this action, otherwise, it depends on the option in the action "Close Document". Document name Specifies name for identifying a document from others, other document related instructions will use the name to select an opened document rather than the path name of the document file. Note: To open a Microsoft Excel document, Microsoft Excel program must be present in the computer before playing a macro. If opening the document failed, the global variable "error" will be set to "ERR".

[email protected]

186 / 213

Help for Macro Expert


Close Document (This action is available in Enterprise Edition only)

Close Document

Closes an opened document, or terminates the connection of document which is opened in the parent task. If the document has been closed before executing the step, the step will be ignored. Parameters Save changes of document before closing it. If the option is checked, Macro Player will attempt to save the changes before closing it. Otherwise, it will discard the changes and directly before closing the document. Note: The document must be opened by the instruction "Open Document", or be connected by the instruction "Connect a Opened Document" before this step. Microsoft Excel program must be present in the computer before playing a macro which contains this instruction.

[email protected]

187 / 213

Help for Macro Expert


Save Document (This action is available in Enterprise Edition only) Saves an opened document. Parameters Document name Specifies the document which should be saved. Note:

Save Document

The document must be opened by the instruction "Open Document", or be connected by the instruction "Connect a Opened Document" before this step. Microsoft Excel program must be present in the computer before playing a macro which contains this instruction.

[email protected]

188 / 213

Help for Macro Expert


Read EXCEL Document Cell (This action is available in Enterprise Edition only)

Read Microsoft Excel Cell

Reads the value or formula of a cell from an opened Microsoft Excel Document, and stores the read data into a variable for using later. Parameters Document name Specifies the document for reading. Worksheet name Specifies the name of the worksheet which contains the cell to be read. Cell Specifies the cell to be read. Read formula Specifies whether to read either the cell value or formula of the cell. Populate variable with result Specifies the variable to hold the read data. Populate variable with state of exceeding rows Stores the number 1 into the variable if the row number exceeds the max row in the used range, otherwise, the number 0 will be stored. You could check out the variable's value to determine if all data have been read/written in the used range. When failed to read from cell Specifies the secondary error level if gets an error during reading. Note: The document must be opened by the instruction "Open Document", or be connected by the instruction "Connect a Opened Document" before this step. Microsoft Excel program must be present in the computer before playing a macro which contains this instruction.

[email protected]

189 / 213

Help for Macro Expert


Write EXCEL Document Cell (This action is available in Enterprise Edition only)

Write Microsoft Excel Cell

Writes the value or formula into a cell of an opened Microsoft Excel Document. Parameters Document name Specifies the name of the opened/connected document. Worksheet name Specifies the name of the worksheet which contains the cell to be written. Cell Specifies the cell to be written. Value to write Specifies the data to write. Write as formula Specifies whether to write into the cell as either the value or the formula. When failed to write data into cell Specifies the secondary error level if gets an error during writing. Note: The document must be opened by the instruction "Open Document", or be connected by the instruction "Connect a Opened Document" before this step. Microsoft Excel program must be present in the computer before playing a macro which contains this instruction.

[email protected]

190 / 213

Help for Macro Expert


Find EXCEL Cell (This action is available in Enterprise Edition only) Searches the worksheet for a cell that matches a specified criteria. Parameters

Find Microsoft Excel Cell

Document name Specifies the document for reading, the document should be opened by the instruction "Open Document" before this step is performed. Worksheet name Specifies the name of the worksheet which contains the cell to be read. Look in column Specifies which column will be searched, the column should be in range from 'A' to 'IV'. Start row Specifies the start row number of the cell, the searching will start from here. Find what Specifies the content to find, it can be a string or any Excel data type. Look in formulas Specifies whether the search matches the cell formula or value. Match case Specifies whether the search is case-sensitive. Match entire cell contents Specifies whether the search matches entire cells or partial cells. Return row number into Specifies the variable to hold the row number if a match is present. If the search does not find any cell, the number -1 will be stored into the variable. Note: The document must be opened by the instruction "Open Document", or be connected by the instruction "Connect a Opened Document" before this step. Microsoft Excel program must be present in the computer before playing a macro which contains this instruction.

[email protected]

191 / 213

Help for Macro Expert


Add Excel Worksheet (This action is available in Enterprise Edition only) Creates a new worksheet, chart, or macro sheet. Parameters Document name Specifies the document name. Worksheet name Specifies the worksheet name.

Add Microsoft Excel Worksheet

Insert position Specifies the position of the new worksheet in the document. Sheet type Specifies the type of the worksheet. Note: The document must be opened by the instruction "Open Document", or be connected by the instruction "Connect a Opened Document" before this step. Microsoft Excel program must be present in the computer before playing a macro which contains this instruction.

[email protected]

192 / 213

Help for Macro Expert


Remove Excel Worksheet (This action is available in Enterprise Edition only) Removes an existed worksheet from the Excel document. Parameters

Remove Microsoft Excel Worksheet

Document name Specifies the document name which is opened prior to this step. Remove manner Specifies how to locate the worksheet that should be removed. Worksheet name or index Specifies the worksheet name or index number. Note: The document must be opened by the instruction "Open Document", or be connected by the instruction "Connect a Opened Document" before this step. Microsoft Excel program must be present in the computer before playing a macro which contains this instruction.

[email protected]

193 / 213

Help for Macro Expert


Activate Excel Worksheet (This action is available in Enterprise Edition only) Activates an existed worksheet in the Excel document. Parameters

Activate Microsoft Excel Worksheet

Document name Specifies the document name which is opened prior to this step. Find manner Specifies how to locate the worksheet that should be activated. Worksheet name or index number Specifies the worksheet name or index number (starts from the number 1). Note: The document must be opened by the instruction "Open Document", or be connected by the instruction "Connect a Opened Document" before this step. Microsoft Excel program must be present in the computer before playing a macro which contains this instruction.

[email protected]

194 / 213

Help for Macro Expert


Wait for MacroSoft Excel Cell (This action is available in Enterprise Edition only)

Wait for Microsoft Excel Cell

Waits for one or more cell until meet the specified criterial. The action is useful when you'd like to monitor some cells in a Microsoft Excel document. Parameters Document name Specifies the document which should be monitored. Cells Specifies the cells to be monitored. Note: The document must be opened by the instruction "Open Document", or be connected by the instruction "Connect a Opened Document" before this step. About the timeout, please click here. Microsoft Excel program must be present in the computer before playing a macro which contains this instruction.

[email protected]

195 / 213

Help for Macro Expert


Connect to Data Source (This action is available in Enterprise Edition only)

Connect to Data Source

Establishes a connection to the data source, or connects the connections is opened in the parent task. After this action successfully completes, the connection is live until close it, and you can issue SQL query against it and process the results. Parameters Connection string Specifies a string used to establish a connection to a data source. The connection string provides driver, server, username, password and other important information to the datasource. The easiest way to generate a connection string is by pressing the right button. Connection name in parent task For the option "Connect to data source in parent task, specifies the connection name of the data source which is opened in the parent task. Location of cursor service Specifies the location of the cursor service. You can choose between using a client-side cursor library or one that is located on the server. Connection name Specifies the name for the data source connection. The name will be referred in subsequent steps for accessing the data source.

[email protected]

196 / 213

Help for Macro Expert


Close Data Source Connection (This action is available in Enterprise Edition only)

Close Data Source Connection

Closes a data source connection, also closes any active dataset associated with the connection. Parameters Connection name Specifies the name for the data source connection. Notes: If the data source is opened in the parent task, the instruction just terminates the connection to it

[email protected]

197 / 213

Help for Macro Expert


T ransaction on Data Source (This action is available in Enterprise Edition only) Manages transaction processing within a data source connection. Parameters Begin transaction Begins a new transaction.

Transaction on Data Source

Commit transaction Saves any changes and ends the current transaction. Rollback transaction Cancels any changes made during the current transaction and ends the transaction. Notes: Not all data providers support transactions .

[email protected]

198 / 213

Help for Macro Expert


Execute SQL Statement (This action is available in Enterprise Edition only)

Execute SQL Statement

Executes the specified query, SQL statement, stored procedure, or provider-specific text on the data source. Parameters Directly connect to data source Specifies a string used to establish a connection to the data source. The connection string provides driver, server, username, password and other important information to the datasource. The easiest way to generate a connection string is by pressing the right button. Use existed data source connection Specifies the data source connection that should be established by the action "Connect to Data Source". SQL statement Specifies the SQL statement, query name or stored procedure name. Return number of records affected by SQL statement (Optional) Specifies the name of the variable, which receives the value of the number of records that the execution the SQL statement affected. Dataset type Specifies the dataset type if a dataset should be created for the results. Dataset name (Optional) Specifies the name for the dataset. The name will be referred in subsequent steps for accessing the data. Notes: A dataset contains multiple records and multiple fields, and it can only be created by this instruction. A dataset name can be used many times in a script, and it will be closed automatically before creating again. To access the data in the dataset, use the instructions "Get Field Value", "Set Field Value", and "Change Current Record Position".

[email protected]

199 / 213

Help for Macro Expert


Connect Dataset in Parent (This action is available in Enterprise Edition only)

Connect Dataset In Parent

Establishes a connection to a dataset, which is opened or connected in the parent task. It usually used to share the dataset between the scripts. Parameters Dataset name Specifies the name of the dataset, which whill be used in this script and its sub scripts. Dataset name in parent task Specifies the name of the dataset which is opened/connected in the parent task.

[email protected]

200 / 213

Help for Macro Expert


Close Dataset (This action is available in Enterprise Edition only) Close an opened dataset. Parameters Dataset name Specifies the name for the dataset which should be closed. Notes:

Close Dataset

If the dataset is opened in the parent task, the instruction just terminates the connection to it.

[email protected]

201 / 213

Help for Macro Expert


Set Field Value (This action is available in Enterprise Edition only) Places the specified value into the field in the dataset. Parameters

Set Field Value

Dataset name Specifies the name of the dataset. The dataset must be opened before. Field name/index Specifies the field name, or the field index number which starts from the number 0. Content Specifies the content to be used to fill the field. Do not log execution message Specifies whether to log the execution message. W ith the option checked, it may avoid redundant log information in some situation. Notes: For more information about the dataset, please refer to "Execute SQL Statement" or "Connect dataset in parent task".

[email protected]

202 / 213

Help for Macro Expert


Get Field Value (This action is available in Enterprise Edition only) Retrieves the data from a opened dataset. Parameters

Get Field Value

Dataset name Specifies the name for the dataset. The dataset must be opened or connected prior to this instruction. Field name/index Specifies the field name or field index number (starts from the number 0). Return read value into variable Specifies the name of the variable that should be populated with the read result. Do not log execution message Specifies whether to log the execution message. W ith the option checked, it may avoid redundant log information in some situation. Notes: For more information about the dataset, please refer to "Execute SQL Statement" or "Connect dataset in parent task".

[email protected]

203 / 213

Help for Macro Expert


Change Current Record Position (This action is available in Enterprise Edition only) Moves the position of the current record in the dataset. Parameters

Change Current Record Position

Dataset name Specifies the name for the dataset. The dataset must be opened before. Move position of current record to Specifies how to move the position of the current record. It can be one of the following: Moves Moves Moves Moves Moves to to to to to the first record the previous record the next record the last record backward or forward x records

Current record position moves to x steps Specifies the number of records that the current record position moves. Return EOF/BOF state into variable Specifies the name of the variable that will be populated with the EOF or BOF state. Do not log execution message Specifies whether to log the execution message. W ith the option checked, it may avoid redundant log information in some situation. Notes: The EOF and BOF state will be stored into the specified variable in the number format. 1 is EOF or BOF, 0 is not. For more information about the dataset, please refer to "Execute SQL Statement" or "Connect dataset in parent task".

[email protected]

204 / 213

Help for Macro Expert

Command Line Usage

Command line Usage Macro Player is designed to allow the user playing a macro from the command line environment, such as batch file, an external program and "Command Prompt". If you want to use Macro Player on the command line, the syntax of the Macro Player command is: "C:\Program files\GrassSoft\Macro Expert\MacroPlayer.exe" "MacroFile.msd" [option1:value1 | option2:value1 | - [...]] Options "MacroFile" Required parameter, specifies the macro file to play, the file name must be quoted by a pair of the double quotation marks.

Speed Specifies the initial speed of playback, the speed value should be in range -10 to 10, and the value 0 indicates the original speed.

Pause Specifies whether to pause before playing back.

Quickplay Specifies 0 or 1 to determine whether showing the play option dialog or not.

T imes Specifies the total repeat times of playback.

Password Specifies the password to play the macro.

-v Specifies the initial value of the variables. Multiple variables should be separated by the ampersand character & and quoted by the double quotation marks. Example Basic usage: MacroPlayer.exe "calc.msd" times:1 Quick play: MacroPlayer.exe "calc.msd" quickplay:1 Given initial play speed: MacroPlayer.exe "calc.msd" quickplay:1 speed:2 Given initial variables value: MacroPlayer.exe "calc.msd" quickplay:1 speed:2 -v"name=jack&age=20"

[email protected]

205 / 213

Help for Macro Expert


Variable and Expression Variable

Variables and Expressions

Variable is a symbol that stands for a value. For example, in the expression x+y+10 x and y are variables, and 10 is a constant. Variables can represent numeric values, character strings, date time or other data type. Variables play an important role in Macro Expert because they enable you to create flexible macros. Rather than entering data directly into a script, you can use variables to represent the data. Then, when the macro is played, the variables are replaced with real data. This makes it possible for the same macro to process different sets of data. For example, you might want to use the action "Mouse Move" for placing the mouse pointer at a position, and the position should be determined when the macro is played. You can use the variable to represent the coordinates value of the position. Depending on the value of variable, the mouse pointer will be placed at the different position. Every variable has a name, called the variable name, and a data type. A variable's data type indicates what sort of value the variable represents. Macro Expert supports 4 data types, String, Number, Datetime and Binary data. The binary data is used to the instruction "Call an External DLL". In Macro Expert, there are two type variables, the global variables and local variables. The global variables are predefined by the software for holding those general content, such as the current time, W indows Directory and etc.. The local variables are restricted to a single macro. This means that you cannot access the variables from a different macro. For more information about working with the local variables, please click here. String Holds sequences character code which represents a single character. The string data type supports + operator and - operator. Example A: "abc"+"bcd" ' The preceding expression evaluates to "abcbcd". Example B: "abcd"-"bc" ' The preceding expression evaluates to "ad". In an expression, the string data should be quoted by the single or double quotation marks. You may use \' to represent the single quotation sign, and use the \" to represent the double quotation sign. For example, Example A: 'He\'s a student.' ' The preceding expression evaluates to "He's a student.". Example B: "He said: \"No\""?br> ' The preceding expression evaluates to "He said: "No"". Number Holds signed IEEE 64-bit (8-byte) double-precision floating-point numbers ranging in value from -1.79769313486231570E+308 through -4.94065645841246544E-324 for negative values and from 4.94065645841246544E-324 through 1.79769313486231570E+308 for positive values. Double-precision numbers store an approximation of a real number.

[email protected]

206 / 213

Help for Macro Expert

Variables and Expressions

The number data type supports + operator, - operator, * operator, / opeartor and \ mod operator. For example, Example A: 1+20 ' The preceding expression evaluates to "21". Example B: 0x10 \ 3 ' The preceding expression evaluates to "1". In an expression, you may use the hexadecimal notation to represent a number, for example, 0x2A. Datetime Holds date and time values. The datetime supports + operator, - operator, * operator, / opeartor. Example A: #2007-08-10#+1 ' The preceding expression evaluates to 2007-08-11. Example B: #2007-08-10#-8 ' The preceding expression evaluates to 2007-08-02. In an expression, the datetime content should be quoted by the number sign #. Binary Holds the binary data of any kind. This data type is used to represent a structural data for the instruction "Call an External DLL". For reading the content in a binary data, you could use the instruction "Advanced Get Variable Value". Array An array is a collection that holds a fixed number of variables. These variables have the same name. Each variable in an array is called an element, and each element is accessed by its numerical index. The numerical index is also called subscript, and it begins with the number 0. The index number (subscript) must be surrounded by square brackets. For example : v_name[1], v_name[2] Expression An expression is a series of value elements (variables or constants) combined with operators, which yields a new value. The operators act on the value elements by performing calculations, comparisons, or other operations. Operator An operator is a code element that performs an operation on one or more value elements that hold values. Value elements include variables, constants, returns from Function and Operator procedures, and expressions. Macro Expert supports +, -, *, /, \(mod) and () operator, and it will convert the right value element to the appropriate data type before performing the operation, as the following example demonstrates. %="abc "+20.03% ' The preceding expression evaluates to "abc 20.03". %=20.03 + "abc"%

[email protected]

207 / 213

Help for Macro Expert


' The preceding expression evaluates to 20.03. %=20.03 + "5abc"% ' The preceding expression evaluates to 25.03. Using Expression

Variables and Expressions

To use an expression, simply quote the expression by percentage signs, and use the equal mark to lead, like this: %=1+2%, or %=5 * VARIABLENAME% (substitute VARIABLENAME for the variable name you used.) The equal mark could be ignored if the expression does not include the operator, for example, %VARIABLENAME%. Special character Percentage sign % Uses the \% to represent the percentage sign in an expression. For example, %="100\%"+"abc"%. New line sign Uses the \n to represent the new line sign in an expression. For example, %="100\n"+"abc"%. T ab character Uses the \t to represent the horization tab character in an expression. For example, %="100\tabc"%. Note: New line sign and T ab character are available only in the experssion.

Note: The number datatype in memory is same as the double-precision floating-point numbers.

The datatime datatype in memory is same as the struct SY STEMTIME in W indows API.

Not all parameters of actions support the expression. If you could see the icon on the right of the parameter field in the instruction parameters dialog, then the parameter supports the expression.

[email protected]

208 / 213

Help for Macro Expert

Frequent Question and Answer

Frequently Asked Questions 1. Why can I only use 21 days? Macro Expert is a shareware, not a freeware. It is a trial version before purchasing it, so you can try it without any risk for a period of 21 days. After the period, if you want to continue using it, you should pay a fee to unlock. To purchase it, please go here. 2. Is there a version of Macro Expert for Mac or Linux? No, Macro Expert can only run under the windows currently. 3. I'd like to use Macro Expert under windows 95, is it possible? No, Macro Expert only run under W indows 98 or above. 4. I'd like to have a macro to run even if the workstation is locked, how do I do? 1. At first, the macro have to be launched automatically, you might schedule it or add some triggers to turn automatically play on. 2. And then you need to change the "Playback" of the macro to allow the macro run under the situation. Just select the macro in the macro list and click "Property" tool button on the toolbar, and then switch to the "Background mode" tab on the properties dialog. 3. Select the "run as a specific user" or "run as background user" in the "If no user is logged or the workstation is locked". 4. If you select the "run as a specific user", don't forget to type the "logon/lock information" 5. I make a mistake to let a macro run at window startup, and the macro will restart the windows, how do I stop it? Please start windows in safe mode, disable the macro and then restart windows again. 6. Can I assign a hotkey to more than one macro? Yes, when this hotkey is pressed, all macros will be launched. 7. Can I stop logging the manager message? Yes, please refer to "General Options". 8. Can I run a macro at a time? Yes, you can schedule the macro to run at a time. 9. How to set the options to prevent Macro Manager from launching when I log into windows?

[email protected]

209 / 213

Help for Macro Expert

Frequent Question and Answer

Open Macro Manager, click the Change Settings and then select "General" tab, uncheck the item "Automatically run Macro Manager when I log on to the windows". 10. I receive a macro script file from my friend, how do I play it? In the windows explorer, right-click the file and select the menu item "Play" or "Play with parameters". Please note: The macro can not be scheduled or triggered to play if a macro is not in the macro list. 11. I have a script file that is not in the macro data folder, can I play it automatically? No, because Macro Service will only manage the macros in the macro folder, so you have to copy or move the file into the macro folder by W indows Explorer. 12. I have closed Macro Manager, but some macros still playback, why? Macro Expert has an important feature which can play the certains macro when a system event occurs, and a macro will play at its scheduled time. Macro Service is responsible for watching conditions that would cause a triggered or scheduled macro to play. It also monitors the hotkey of macro. A triggered or scheduled macro will be launched even if you quit Macro Manager. To stop this, you have to to disable all triggers or stop the Macro Service.

[email protected]

210 / 213

Help for Macro Expert

Purchasing Macro Expert

[email protected]

211 / 213

Help for Macro Expert


Contact Grass Software T echnical Support

Contact Grass Software

If you need technical support, please feel free to contact us at [email protected] and include your name, address, email address. We will be happy to help you. W hen you post a technical support issue, you should include: System configuration (CPU, RAM, OS, DISK SPACE, etc.) Detailed problem description (include exact error message text) How to reproduce the problem. Sales If you have sales, marketing, OEM bundling or resellers related inquiry, please contact us at: [email protected]. Comments If you want to comment on Macro Expert, Please let us know, we'd love to hear from you. Please send to [email protected].

[email protected]

212 / 213

Help for Macro Expert


License Agreement

License Agreement

END USER LICENSE AGREEMENT REGIST ERED VERSION PLEASE READ T HIS LICENSE CAREFULLY BEFORE USING T HIS SOFT WARE. The Macro Expert is a shareware (try-before-you-buy). This means: - All copyrights to Macro Expert are exclusively owned by Grass Software. - Anyone may use this software during a test period of 21 days. Following this test period of 21 days or less, if you wish to continue to use Macro Expert, you MUST register. - Once registered, the user is granted a non-exclusive license to use Macro Expert on special amount of computers, for any legal purpose, at a time. The registered Macro Expert software may not be rented or leased, but may be permanently transferred, if the person receiving it agrees to terms of this license. If the software is an update, the transfer must include the update and all previous versions. - The Macro Expert unregistered shareware version may be freely distributed, provided the distribution package is not modified. No person or company may charge a fee for the distribution of Macro Expert without written permission from the copyright holder. - Macro Expert IS DISTRIBUTED "AS IS". NO W ARRANTY OF ANY KIND IS EXPRESSED OR IMPLIED. Y OU USE AT Y OUR OW N RISK. THE AUTHOR W ILL NOT BE LIABLE FOR DATA LOSS, DAMAGES, LOSS OF PROFITS OR ANY OTHER KIND OF LOSS W HILE USING OR MISUSING THIS SOFTW ARE. - You may not use, copy, emulate, clone, rent, lease, sell, modify, decompile, disassemble, otherwise reverse engineer, or transfer the licensed program, or any subset of the licensed program, except as provided for in this agreement. Any such unauthorized use shall result in immediate and automatic termination of this license and may result in criminal and/or civil prosecution. All rights not expressly granted here are reserved by Grass Software. - Installing and using Macro Expert signifies acceptance of these terms and conditions of the license. - If you do not agree with the terms of this license you must remove Macro Expert files from your storage devices and cease to use the product. CONTACT INFORMATION =================== Tech Support: [email protected] Reg & Sales: [email protected] Grass Software: http://www.macro-expert.com

[email protected]

213 / 213

You might also like