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

Macro Expert Manual

Embed Size (px)

Citation preview

Page 1: Macro Expert Manual

Table of Contents

1Introduction ................................................................................................................................................................................................3Compare Editions .................................................................................................................................................................................4Installation and Uninstall ................................................................................................................................................................4Minimum system requirements ....................................................................................................................................................5Installnation ...........................................................................................................................................................................................6Uninstalling ............................................................................................................................................................................................7Work environment ................................................................................................................................................................................7Getting familiar with Macro Manager .........................................................................................................................................

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

Page 2: Macro Expert Manual

51Play back .............................................................................................................................................................................................52Record ..................................................................................................................................................................................................53Macro list .............................................................................................................................................................................................54Auto-logon ..........................................................................................................................................................................................55Appearance ........................................................................................................................................................................................56Script Editor ...........................................................................................................................................................................................56Looking at the work area ..............................................................................................................................................................57Inserting an action ...........................................................................................................................................................................58Editing an action ..............................................................................................................................................................................59Removing one or more actions .................................................................................................................................................60Working with the variables ..........................................................................................................................................................61Macro Commands .............................................................................................................................................................................61General settings and Error Handling Options .....................................................................................................................62Keyboard and mouse .....................................................................................................................................................................62Key action ....................................................................................................................................................................................63Mouse action ...............................................................................................................................................................................64Put a Text .....................................................................................................................................................................................65Mouse Move Activity ..................................................................................................................................................................66Mouse Action on Object ...........................................................................................................................................................67Series Keystrokes ......................................................................................................................................................................68Dialog ....................................................................................................................................................................................................68Display Message Dialog ...........................................................................................................................................................69Select a Folder ............................................................................................................................................................................70File-selection Dialog ..................................................................................................................................................................71Input Dialog .................................................................................................................................................................................72Show Tip Text ..............................................................................................................................................................................73Hide tip text ..................................................................................................................................................................................74Choice Dialog ..............................................................................................................................................................................75Window ................................................................................................................................................................................................75Window action ............................................................................................................................................................................76Wait .......................................................................................................................................................................................................76Delay .............................................................................................................................................................................................77Wait for a window ......................................................................................................................................................................78Wait for color ...............................................................................................................................................................................79Wait for keystroke ......................................................................................................................................................................80Wait for mouse motion .............................................................................................................................................................81Wait for file ..................................................................................................................................................................................82Wait for process .........................................................................................................................................................................83Play Control .......................................................................................................................................................................................83On Error ........................................................................................................................................................................................84Pause ............................................................................................................................................................................................84Stop ...............................................................................................................................................................................................84End ................................................................................................................................................................................................84Play speed ...................................................................................................................................................................................85Play a macro ...............................................................................................................................................................................86Set emulation level ....................................................................................................................................................................87Block/unblock mouse and keyboard .....................................................................................................................................88Log a Playback Message .........................................................................................................................................................89Variable ................................................................................................................................................................................................89Increase/Decrease value ..........................................................................................................................................................90Set value ......................................................................................................................................................................................91Advanced Set Variable Value ..................................................................................................................................................93Advanced Get Variable Value .................................................................................................................................................94Redefine Variable .......................................................................................................................................................................

Page 3: Macro Expert Manual

95Text ........................................................................................................................................................................................................95Convert Text .................................................................................................................................................................................96Pad Text ........................................................................................................................................................................................97Split Text .......................................................................................................................................................................................98Trim Text .......................................................................................................................................................................................99Find Text .......................................................................................................................................................................................

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

Page 4: Macro Expert Manual

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

Page 5: Macro Expert Manual

197Close Data Source Connection ...........................................................................................................................................198Transaction on Data Source ................................................................................................................................................199Execute SQL Statement ........................................................................................................................................................200Connect Dataset In Parent ...................................................................................................................................................201Close Dataset ..........................................................................................................................................................................202Set Field Value .........................................................................................................................................................................203Get Field Value ........................................................................................................................................................................204Change Current Record Position ........................................................................................................................................205Command Line Usage ................................................................................................................................................................206Variables and Expressions .....................................................................................................................................................209Frequent Question and Answer ..........................................................................................................................................211Purchasing Macro Expert .........................................................................................................................................................212Contact Grass Software ............................................................................................................................................................213License Agreement .......................................................................................................................................................................

Page 6: Macro Expert Manual

Introduction

Welcome to Macro Expert. Macro Expert is a powerful utility that is designed for automating theplodding and repetitive tasks. It will greatly simplify your work, increase your productivity, andfree your time for other important jobs. W ith a tight integration scheduler, all of macros can belaunched at specific time. All of macros even can be launched when some events occur, such asdisk free space is low, a removable driver is arrived. Both of the ways give you an ability to dosome unattended tasks.

Ease of use

Macro Expert is intuitive and a breeze to use. Tool buttons are used for all of functions becauseit is handy and clear to most users. Initial trainning and orientation time is reduced, allowingusers to focus on producing results rather than learning how to use. No programming skillsrequired!

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 thecircumstance.

Scheduler

Every managed macro can be scheduled to play back, you can schedule a macro to run atspecific 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.

Trigger

By Macro Expert Service, every managed macro can be triggered. It means every triggeredmacro will be launched when some events occur, such as disk free space is low, a removabledriver is removed and much more.

Hot key

Every managed macro can be assigned to a hot key, when the key sequence is pressed, MacroExpert will launch the macro. Sometimes it is the most convenient way to complete a task.

TemporaryMacro

In Macro Expert, macros have two kinds, named macros and TemporaryMacro. The namedmacros enable you to name, describe, and add a password to protect the actions you record. Anamed macro can be scheduled and triggered. The TemporaryMacro enables you to quicklycapture your mouse and keyboard input without having to name a macro, provide a descriptionfor it.

Password protected

You are able to add a password to a named macro. It should help you prevent unauthorizedaccess 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 insome case, perhaps you'd like to record either keystrokes or mouse actions, we provide optionsto do so in Macro Expert.

Help for Macro Expert Introduction

[email protected] 1 / 213

Page 7: Macro Expert Manual

Interface colorable

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

Help for Macro Expert Introduction

[email protected] 2 / 213

Page 8: Macro Expert Manual

Compare Editions

Feature Standard Edition Enterprise Edition

Trigger

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

Help for Macro Expert Compare Editions

[email protected] 3 / 213

Page 9: Macro Expert Manual

Minimum system requirements

To use Macro Expert properly, your system should meet or exceed the minimum systemrequirements 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

Windows NT 4.0 with Service Pack 4, 2000, XP, 2003, Vista

*All other brands and names are property of their respective owners.

Help for Macro Expert Minimum system requirements

[email protected] 4 / 213

Page 10: Macro Expert Manual

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, justsimply launch it to start out the setup progress.

You will be prompted with a few questions during the setup progress, such as whichcomponents need to install, where you wish the product install to, and so on. After theprogress, the program will copy all necessary files into your computer and create shortcuts tothe 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.

Help for Macro Expert Installnation

[email protected] 5 / 213

Page 11: Macro Expert Manual

Uninstalling

To 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.

Help for Macro Expert Uninstalling

[email protected] 6 / 213

Page 12: Macro Expert Manual

Getting familiar with Macro Manager

The Macro Manager is a tool for administering macros, and controlling Macro Service. You utilizeit to do the following:

Creating a new macroImporting an existing script file as a managed macroAdding or removing the triggers from a macroScheduling a macroAdding or removing a Systray menu itemChanging the properties of a macroSetting the global system optionsSuspending/resuming Macro Service

The work area of Macro Manager is activated when Macro Manager is started. The work areaconsists of the Menu bar, the Folder Panel, the Macro list tab, the Status panel and a systrayicon.

Systray Icon

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

Help for Macro Expert Getting familiar with Macro Manager

[email protected] 7 / 213

Page 13: Macro Expert Manual

Folder Panel

The Folder Panel is on the left of the main screen, it provides you with a access for browsingthe 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 areconvenient 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 willpopup 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 learnthe current state of the macro manager and macro service, the actions to a macro, all of theproperties on a macro and etc.

Help for Macro Expert Getting familiar with Macro Manager

[email protected] 8 / 213

Page 14: Macro Expert Manual

Manager log

The panel will show all the logs from Macro Manager, the log contains events logged by MacroManager. For example, a log record will be added when you suspend or resume the MacroService, 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 GeneralOptions.

Service log

The panel will show the logs about Macro Service, the service log contains all thecommunication message between the service with other programs, and the records indicate amacro to be launched by scheduler or trigger.

Playback log

Playback log contains the message during the macro playback, such as when the macro waslaunched, 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, lastplay and so on. That is more intuitive to the grid.

Help for Macro Expert Getting familiar with Macro Manager

[email protected] 9 / 213

Page 15: Macro Expert Manual

Folder Panel

The folder panel allows you to browse all macro under the data path, all used hotkeys, allscheduled and triggered macro.

Click here to show the figure

Macro Explorer

Under the panel, you may:

Creating a folderRemoving a folderRenaming a folderCreating a macroRemoving a macro

Hotkeys

Under the panel, you may:

Adding a macro for a hotkeyReassigning a macro to a hotkeyRemoving a hotkeyed macro

Schedulers

Under the panel, you may:

Adding a macro for a schedulerReassigning a macro to a schedulerRemoving a scheduled macro

Triggers

Triggers are events that cause a macro to playback. Under the panel, you may view allavailable triggers.

Adding a macro for a triggerReassigning a macro to a triggerRemoving a triggered macro

Systray Menu

Under the panel, you may:

Adding a menu item.Editing a menu item.Removing a menu item.

Help for Macro Expert Folder panel

[email protected] 10 / 213

Page 16: Macro Expert Manual

The tool bar of the macro list

The tool bar provides a quick access to Macro Expert's common features which are used tomanipulate the macros.

Plays the selected macro, it will open a dialog to prompt you determining someparameters 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 beforeplaying.

Loads the data of macro into the script editor for editing.

Rerecord the selected macro, the original scripts will be overwritten with the new contentwhen 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 notbe appeared in the systray menu.

Enables the disabled macro, trigger or menu item.

Help for Macro Expert The tool bar of the macro list

[email protected] 11 / 213

Page 17: Macro Expert Manual

Working with the progress window

The progress window is a dialog box that enables you to stop, pause and resume the processduring playing or recording. In the period of playing, it also displays a progress bar to showyou what the current position is in the actions of the macro.

The image below shows you what the progress window looks like.

Help for Macro Expert Working with the progress window

[email protected] 12 / 213

Page 18: Macro Expert Manual

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 runningmacros"

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

Help for Macro Expert Working with Macro Player Manager

[email protected] 13 / 213

Page 19: Macro Expert Manual

Basic concept

If you are new to Macro Expert, you need to learn some basic concepts, it is helpful to useMacro Expert.

Macro Expert

Macro Expert is a collection of several separate applications, all working together to act likeone cohesive unit. These applications are the Macro Manager, the Macro Service, the MacroScript Editor and the Macro Player.

Macro Service is responsible for administering the macro list, watching for conditionsthat would cause a triggered or scheduled macro to play. It also monitors the hotkey ofmacro. 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 newmacro, importing an existing macro, removing a macro from the list, setting the globaloptions, changing the property of a macro and much more.

Macro Script Editor is a tool for editing macro actions. Although a macro can becreated by recording, but the recording only captures the mouse and the keyboardactivities. You should use Macro Script Editor to get other useful actions, such aswaiting for a window focused, displaying a message box of notice, copying or movingfiles.

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

What is macro?

A set of keystrokes, mouse actions and instructions that are recorded, saved, edited. Therecorded 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, asingle macro keystroke can open many websites at once, enter your name and address withpressing a hot key.

Trigger

The condition that causes a macro to playback. This can be based on a time and date or asystem event( such as there isn't enough space for the disk, time is changed, or many othercriteria).

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 ortriggered.

TemporaryMacro

The TemporaryMacro enables you to quickly record your actions without having to name amacro, providing a description for it, or reviewing the resulting macro file. This also saves yousome keystrokes whenever you want to run the TemporaryMacro, as it remains available untilyou record TemporaryMacro again.

Help for Macro Expert Basic concept of Macro Expert

[email protected] 14 / 213

Page 20: Macro Expert Manual

Variable

A symbol can hold different values at different times. For example, running the macro, thevariable 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 samename. Each variable in an array is called an element, and each element is accessed by itsnumerical index. The numerical index is also called subscript, and it begins with the number0. 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. Theoperators act on the value elements by performing calculations, comparisons, or otheroperations.

Unattended playback

Automatical playback, that is playing a macro without pressing the hotkey or clicking thetoolbar 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. Ifyou 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.

Help for Macro Expert Basic concept of Macro Expert

[email protected] 15 / 213

Page 21: Macro Expert Manual

Create a new macro

To create a macro by recording keyboard and mouse activities:

1. Under the menu "Script", select the item "New Macro Wizard" to launch the wizardfor a new macro.

2. If recording is selected, the parameters dialog will appear to ask you to set optionsfor recording.

3. Click OK to start recording.4. When 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 andmouse 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 progresswindow to abort the capture process and save the actions.

To 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 quicklyknow 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 thefield, 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 delaybetween 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

Help for Macro Expert Creating a new macro

[email protected] 16 / 213

Page 22: Macro Expert Manual

Capture the mouse movements and store them.

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 tabunder the Options dialog, the new macro dialog will open after you finished recording. In thiscase, the last recording parameters will be used.

Help for Macro Expert Creating a new macro

[email protected] 17 / 213

Page 23: Macro Expert Manual

Playing a macro manually

There are two ways to play a macro manually, regular playing and quick playing. The quickplaying differs from the regular playing slightly, which does not open a play dialog box forasking playback options. About to play a macro automatically, please see the following:

Scheduling a macroTriggering a macro

To play a macro regularly:

1. Click on the Macro Explorer tab.2. Select the macro which you'd like to play.3. Click the tool button Play, the play dialog will popup.4. After determine the options for playing, click the OK to start playing.

To 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.

The 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 initialspeed level of playback.

Repeat

Replay the macro continuously until you stop it.

Pause after clicking the OK button

With the option checked, after you click OK, the playing progress will be suspended until youresume it.

Emulation level

Specifies the emulation level of the mouse and keyboard acvitity. The hardware level emulationwill 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 overthe progress window, the progress window will move to dodge the mouse pointer. You may takethe 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

Help for Macro Expert Playing a macro manually

[email protected] 18 / 213

Page 24: Macro Expert Manual

Specifies the initial value to the variables. Multiple variables may be specified by separatingentries with the character &. If you specify multiple values to a variable, the last value will beused, for example: v_var1=123&v_var1=567&v_var1=88, the value of the variable v_var1will 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.

Help for Macro Expert Playing a macro manually

[email protected] 19 / 213

Page 25: Macro Expert Manual

Recording/Editing TemporaryMacro

The TemporaryMacro allows you to quickly record keyboard and mouse activities without havingto name a macro and providing a description to it. The actions of the TemporaryMacro willremain available until you record TemporaryMacro again.

To Record TemporaryMacro:

Under the menu "TemporaryMacro", select the item "Record TemporaryMacro"..

To Edit TemporaryMacro:

Under the menu "TemporaryMacro", select the item "Edit TemporaryMacro". Youalways edit the TemporaryMacro even if it's not been recorded..

Notes:

Pressing the hotkey is a best way to record TemporaryMacro, this method is moreconvenient than using the menu. The hotkey for recording TemporaryMacro can becustomized on the "Hotkey" tab under the "Change Settings".You can change the options of recording TemporaryMacro on the "TemporaryMacro"tab under the "Change Settings".

Help for Macro Expert Recording/Editing TemporaryMacro

[email protected] 20 / 213

Page 26: Macro Expert Manual

Playing TemporaryMacro

To play TemporaryMacro:

Under the menu "TemporaryMacro", click "Play TemporaryMacro" to start playing.

Notes:

Pressing the hotkey is a best way to play TemporaryMacro, this method is moreconvenient 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"TemporaryMacro" tab under the "Change Settings".

Help for Macro Expert Playing TemporaryMacro

[email protected] 21 / 213

Page 27: Macro Expert Manual

Stopping or start 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 belaunched automatically.

To suspend:

Under the menu "File", selects the item "Stop Macro Service".

To 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 thehotkeys, please refer to Hotkey Settings.

Help for Macro Expert Stop Macro Service

[email protected] 22 / 213

Page 28: Macro Expert Manual

Disabling/Enabling all triggers of macro

To 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.

Help for Macro Expert Disabling all triggers of macro

[email protected] 23 / 213

Page 29: Macro Expert Manual

Changing the general properties

Every named macro has many properties, such as name, description, related hotkey, etc.

To 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 contextmenu, and then switch to the "General" tab.

Click here to show the figure

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. Andyou 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 thehotkey, click the button "Clear Hotkey".

Also, you may attach a condition on the hotkey to make the hotkey available only whenspecified 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.

Help for Macro Expert General

[email protected] 24 / 213

Page 30: Macro Expert Manual

Changing the scope of macro

Every named macro can be restricted to play when a specified window exists. In some casesthis is necessary for ensuring the macro's actions to perform right.

To 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 thenclick the "Scope" tab.

The scope of macro dialog:

Click here to show the figure

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.

Top 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.

This 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 "This macro will apply to all windows." checked, the macro will runimmediately without a window existing or not.

Help for Macro Expert Scope

[email protected] 25 / 213

Page 31: Macro Expert Manual

Changing the triggers of a macro

Trigger is a way for playing a macro automatically. You can utilize the trigger to complete someunattended tasks. Such as restarting the computer, deleting all of temp file up and so on.

To 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 contextmenu, and then switch to the "Triggers" 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.

Help for Macro Expert Triggers

[email protected] 26 / 213

Page 32: Macro Expert Manual

Changing the schedule of macro

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.

To 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 contextmenu, 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 macrolist.

Help for Macro Expert Schedule

[email protected] 27 / 213

Page 33: Macro Expert Manual

Playback Tab

Click here to show the figure

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 movesover the progress window, the progress window will move to dodge the mouse pointer. You maytake 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 bythe instruction "Adjust Speed".

Initial variable value

Specifies the initial value to the variables. Multiple variables may be specified by separatingentries with the character &. If you specify multiple values to a variable, the last value will beused, for example: v_var1=123&v_var1=567&v_var1=88, the value of the variable v_var1will be 88.

Emulation level

Specifies the emulation level of the mouse and keyboard acvitity. The hardware level emulationwill 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 theperformance of the computer hardware is not enough fast, and it may cause high CPU usagewith 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, theaction 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 routinefirst attempts to receive the user name on the logon screen, and then searches for thecorresponding 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.

Help for Macro Expert Play back

[email protected] 28 / 213

Page 34: Macro Expert Manual

Advance Tab

To change the advance properties of a 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", and then switch tothe "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 themaximum 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 thefollowing:

Nothing.Disable all triggers.

If an error is occurred

Specifies an action that should be executed when an error occurs during playing. The action canbe 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 oneof 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.

Help for Macro Expert Advance

[email protected] 29 / 213

Page 35: Macro Expert Manual

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

Help for Macro Expert Advance

[email protected] 30 / 213

Page 36: Macro Expert Manual

Overview of triggering macro

Unlike the scheduler of macro, trigger does not have to be based on a moment in time. It maybe based on one or more system events. Whenever, a system event occurred and a macro hasbeen triggered with it, the macro will be launched automatically.

Macro Expert provides many trigger options for you, the following is the list of availableoptions:

Idle Trigger

Launches the macro when your computer enters the idle(no keyboard and no mouse input)state for the specified period of time.

Startup Trigger

Launches the macro when a user is logged on windows, or windows is started.

System Trigger

Launches the macro when a system event is occurred, such as time is changed, displayresolution is changed, and etc.

Resource Trigger

Launches the macro when a system resource event is occurred, such as free disk space is lowand etc.

Driver Trigger

Launches the macro when a removable driver is inserted into the computer or removed from thecomputer.

Dial Trigger

Launches the macro when a remote access connection is established or terminated.

Window Trigger

Launches the macro when a window is opened, closed, activated or deactivated.

Help for Macro Expert Triggering macro overview

[email protected] 31 / 213

Page 37: Macro Expert Manual

Idle Trigger

Help for Macro Expert Idle trigger

[email protected] 32 / 213

Page 38: Macro Expert Manual

Startup Trigger

Help for Macro Expert Startup trigger

[email protected] 33 / 213

Page 39: Macro Expert Manual

System Trigger

Help for Macro Expert System event trigger

[email protected] 34 / 213

Page 40: Macro Expert Manual

Resource Trigger

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

Help for Macro Expert Resource event trigger

[email protected] 35 / 213

Page 41: Macro Expert Manual

Driver Trigger

Help for Macro Expert Driver trigger

[email protected] 36 / 213

Page 42: Macro Expert Manual

Dial Trigger

Help for Macro Expert Dial trigger

[email protected] 37 / 213

Page 43: Macro Expert Manual

Hotkey

Click here to hide the figure

Parameters

Key combination Specifies the hotkey combination you want to use. You may pressthe key combination in the field or click the right button to choose one.

Launch when following window is active Specifies the condition of activating thehotkey. You may use the options to make the hotkey combination only available in aparticular window.

Play times when key combenation is pressed Specifies the times of playback.

Help for Macro Expert Hotkey

[email protected] 38 / 213

Page 44: Macro Expert Manual

Window Trigger

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 specifiedin the application for indicating a kind of the window. For example, all open WindowsNotepad windows have a same class name "Notepad".

Match whole words

If checked, specifies that the text specified in the field "Window title / Window classname" 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 windowsmay changed when the document is completed loaded.

Note

When a window event occurs, the watcher will pass the handle value of the matchedwindow to the player, so that you could use the handle value to perform other tasksuch as maximizing the window, minimizing the window. To retrieve the window handlevalue, use the global variable "window_watcher_hwnd" in your macro.

Help for Macro Expert Window Trigger

[email protected] 39 / 213

Page 45: Macro Expert Manual

File Trigger

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 asingle semicolon, and standard Microsoft MS-DOS wild cards, such as "*", arepermitted.

Exclude mask

Specifies one or more file names which should be ignored. Each file name must beterminated 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 adomain and if the computer Macro Expert is running on has at least Read access to thefolder being monitored. The trigger will not work on mapped drives or network sharesthat 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.

When a file event occurs, the watcher will pass the matched file name and action typeto the player, you could use the global variable "file_watcher_file" to retrieve the filename, and "file_watcher_action" to determine what event (action) is happen. Thevalue 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

Help for Macro Expert File Trigger

[email protected] 40 / 213

Page 46: Macro Expert Manual

Overview of scheduled macro

Every named macro can be scheduled to launch, you can schedule it to run at a specific timethat 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 withoutyour supervision.

Macro Expert provides many scheduling options for you, the following is the list of availableoptions:

Minute

Specifies the macro to launch once every X number of minutes, hours or seconds. Under theschedule 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 canalso 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 allowedto 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 forplaying.

At a time

This option allows the macro to play at a specific time, you can specify up to 32 specific timepoints.

Once

This option allows the macro to play at a specific time and only launch one time.

Help for Macro Expert Scheduling macro overview

[email protected] 41 / 213

Page 47: Macro Expert Manual

Minute

Click here to hide the figure

The time of next launch

Specifies a time that you want the macro to begin working. This time will be modified aftercompleting scheduled playback.

Help for Macro Expert Minute

[email protected] 42 / 213

Page 48: Macro Expert Manual

Daily

Click here to hide the figure

The 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 EveryN days.

Help for Macro Expert Daily

[email protected] 43 / 213

Page 49: Macro Expert Manual

Weekly

The date of next launch

Specifies a time that you want the macro to begin working. This time will be modified aftercompleting scheduled playback.

Help for Macro Expert Weekly

[email protected] 44 / 213

Page 50: Macro Expert Manual

Monthly

The date of next launch

Specifies a time that you want the macro to begin working. This time will be modified aftercompleting scheduled playback.

Help for Macro Expert Monthly

[email protected] 45 / 213

Page 51: Macro Expert Manual

Once

The date of launch

Specifies a time that you want the macro to execute.

Help for Macro Expert Once

[email protected] 46 / 213

Page 52: Macro Expert Manual

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.

Help for Macro Expert At a time

[email protected] 47 / 213

Page 53: Macro Expert Manual

General Tab

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 asimporting 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, butyou 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, itmeans a triggered or scheduled macro will be launched yet. To stop this, you must suspendthe 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 ispaused even if it is specified to be invisible.

Help for Macro Expert General

[email protected] 48 / 213

Page 54: Macro Expert Manual

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, andpressing the hot key again will resume the process.

Stop playing or recording

When 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 nexttime of starting service.

Record a new macro

Create a new macro via the wizard.

Record TemporaryMacro

Starts a process of recording TemporaryMacro.

Play TemporaryMacro

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.

Help for Macro Expert Hot keys

[email protected] 49 / 213

Page 55: Macro Expert Manual

TemporaryMacro Tab

Click here to show the figure

Record keystrokes

All the keystrokes will be tracked and translated into the macro actions, but the delay ofbetween 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 coordinatesto the foreground windowto the current position

Pause before starting to record TemporaryMacro.

Specifies whether to start the recording process at once, otherwise you need to resume theprocess.

Just play one time

If this option is unchecked, TemporaryMacro will continuously play until you stop it.

Play a sound before playing TemporaryMacro.

Specifies whether to play a sound to inform you that macro will start to play.

Pause before starting to play TemporaryMacro

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 thevalue 10 is fastest.

Help for Macro Expert TemporaryMacro

[email protected] 50 / 213

Page 56: Macro Expert Manual

Playback Tab

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 progresswindow 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 theoption to be sure that the mouse click action perform correctly on the window, otherwise, theprogress window may be clicked unexpectedly. This is a global option, you also specify theoption 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.

Help for Macro Expert Play back

[email protected] 51 / 213

Page 57: Macro Expert Manual

Record Tab

Click here to show the figure

Record keystrokes

All the keystrokes will be tracked and translated into the macro actions, but the delay ofbetween 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 coordinatesto the foreground windowto the current position

Fill properties after recording.

If this option is checked, the recording progress will start immediately rather than ask you toset 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 maytake the option checked to prevent the monitor window from disturbing the process ofrecording.

Play sound for reminding

Specifies whether to play a sound to inform before or after recording.

Help for Macro Expert Record

[email protected] 52 / 213

Page 58: Macro Expert Manual

Macro list Tab

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 beone of the following:

quick play the macro.play the macro.view/modify the properties of macro.edit the script of macro.

Help for Macro Expert Macro list

[email protected] 53 / 213

Page 59: Macro Expert Manual

Auto-logon Tab

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 islocked.

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 andwaiting for a user to log in. Macro Expert attempts to do one of three ways:

Don't runSince most macros require interaction with the desktop, and such interaction can only bedone when a user is logged on and the workstation is not locked, this default optionprovides greatest compatibility with various scenarios.

Run as background userMacro Expert will attempt to launch the macro in the background mode. Under this mode, themacro that interacts with application interfaces will not be function correctly. Thus, thisoption is recommended for non-interactive task, such as file task, database task, and othertasks without user knowledge or intervention.

Run as specified userIf the workstation is locked or there is no current user. Macro Expert will attempt to unlock orlogon, and the macro will be launched if Macro Expert determines that the logon/unlockattempt is successful. Before activating the option, the user name password pairs must bedefined 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.

Help for Macro Expert Auto-logon

[email protected] 54 / 213

Page 60: Macro Expert Manual

Appearance Tab

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 themouse button down and move it to the left or right.

Help for Macro Expert Appearance

[email protected] 55 / 213

Page 61: Macro Expert Manual

Getting familiar with Macro Script Editor

The Macro Script Editor is a tool designed to modify the actions of a macro. You can launch itfrom 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 listAt the left of work area, the actions tree lists all of available actions, you can double-click an action to insert one into the script.Variables listAt the left-bottom of work area that is a list box. It lists all the user defined variables.Script windowFor inserting, editing and deleting the actions of script.

The following illustration shows you what the Macro Script Editor looks like.

About Script Editoroptions, please refer Editor Options.

Help for Macro Expert Looking at the work area

[email protected] 56 / 213

Page 62: Macro Expert Manual

Inserting an action

There are two ways to insert a new 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.

Help for Macro Expert Inserting an action

[email protected] 57 / 213

Page 63: Macro Expert Manual

Editing actions

To edit one action

Selects an item that you'd like to edit in the script window, and clicks the "Edit" buttonon the toolbar or presses RETURN key.

To edit more than one actions

Selects the items that you'd like to edit, and presses RETURN key or clicks the "Edit"button on the toolbar.

Notes:

To disable/enable items quickly, selects the items you'd like to disable/enable, andpresses SPACE key.

To select more than one items, you need first to select an item, and then press SHIFTand click the mouse or press SHIFT and up or down arrow keys to extend the selectionfrom previously selected item to the current item.

Help for Macro Expert Editing an action

[email protected] 58 / 213

Page 64: Macro Expert Manual

Removing actions

To remove one action

Selects an item that you'd like to remove in the script window, and presses theDELETE key or clicks the "Remove" button on the toolbar.

To remove more than one actions

Selects the items that you wan to remove, and presses the DELETE 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 SHIFTand click the mouse or press SHIFT and up or down arrow keys to extend the selectionfrom previously selected item to the current item.

Help for Macro Expert Removing one or more actions

[email protected] 59 / 213

Page 65: Macro Expert Manual

Working with variables

Variable is a symbol that can hold temporary values when a macro is playing. You might use itto 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 allowsyou 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...". Asan 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, andthen 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, andthen selects the menu item "Remove a variable...". In this case, you can also clickthe button on the variables list to remove the variable.

The below illustration shows you what the variables list looks like.

Help for Macro Expert Working with the variables

[email protected] 60 / 213

Page 66: Macro Expert Manual

General settings and Error Handling Options

Error Handling Options

If an error occurred during playing this action, one of the following action should becarry out.

Throw 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 followingactions.

Playback log for this action

Specifies the log level for this action only, the option will overwrite the log settings ofthe script.

General Parameters

Delay before playing this action Specifies the time interval to suspend before playingthe 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 executingthe action OK or not.

Help for Macro Expert General settings and Error Handling Options

[email protected] 61 / 213

Page 67: Macro Expert Manual

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.

Evaluete expression as a character Specifies how to evaluete the expression. W iththe option checked, the first character of the value of evaluating the expression will bethe 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 beheld down or released.

Help for Macro Expert Key action

[email protected] 62 / 213

Page 68: Macro Expert Manual

Mouse actions

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 orright.

position is relative to Specifies how to calculate the mouse cursor's position, it can beone of the following:

Relative to the screen coordinatesAbsolute coordinates, start from the top-left of the screen.

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

Relative to the current positionRelative 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 hotkeyto 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 Text search based on image to retrieve the position of thespecified text.

Help for Macro Expert Mouse action

[email protected] 63 / 213

Page 69: Macro Expert Manual

Put Text

Putting a text into the focused window, it is more convenient than "Key Stroke " to inputinformation such as your name, address and others.

Parameters

Put text into the focused window via the clipboard If this option is checked, the textwill first put into the clipboard, and then paste it into the focused window from theclipboard.

Time interval Specifies how long If this option is checked, the text will first put intothe 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 thefocused window via the clipboard", it makes ensure to input the text correctly.

Help for Macro Expert Put a Text

[email protected] 64 / 213

Page 70: Macro Expert Manual

Mouse Move Activity

The instruction is different from "Move Mouse", it allows up to 16383 mouse move actions toassemble into one step. It would make editing mouse action more easer than even, you justcopy/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 beone of the following:

Relative to the screen coordinatesAbsolute coordinates, start from the top-left of the screen.

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

Relative to the current positionRelative 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.

Time interval Sepcifies the minimum time interval for which execution is to besuspended, in milliseconds.

Capture tool

It is a tool for acquiring the position data of mouse pointer. You press the button 'Acquire ' tostart, and then drag the pointer to acquire data.

Tolerance Specifies a time interval to determine how frequently the capture acquires theposition data, in milliseconds. Bigger value causes to acquire less amount of the position data.

Help for Macro Expert Mouse Move Activity

[email protected] 65 / 213

Page 71: Macro Expert Manual

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 objectdirectly 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 mousepointer should be moved to before carring out the action. The position coordinates arerelative 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 rightborder of the object.

Y Specifies the Y of the position in the object, which is relative to the top of theobject.

X coordiante is right-to-left W ith this option checked, the X will start from right-to-left instead of left-to-right.

Notes:

For more information about locating a UI object, please refer to "Find a UI object".

Help for Macro Expert Mouse Action on Object

[email protected] 66 / 213

Page 72: Macro Expert Manual

Series Keystrokes

Simulating a series of keystrokes to the focused window.

Parameters

Keystrokes Specifies the keystrokes to send to the focused window.

Keep current foreground window focues value W ith the option checked, the windowthat is currently at the front when the action starts will be re-focused before simulatingeach keystroke.

Lock keyboard and mouse Specifies whether to lock keyboard and mouse during theexecution of the action. The keyboard and mouse will be unlocked automatically whenthe action is finished.

Don't show keystrokes in action list W ith the option checked, the keystrokes will beshown as the asterisk charcters in the Macro Editor.

Time interval value between keystrokes Specifies the delay value betweensimulating each keystroke.

Notes:

Each keystroke is represented by one or more characters. You may use the characteritself to specify the keystroke. For example, to represent the letter A, use A. Torepresent special key, you must enclose them in braces. For example, {Backspace},{Return}. The key combination is allowed, you must use the braces to enclose themas well. For example, {Ctrl+S}, {Shift+A}.

Help for Macro Expert Series Keystrokes

[email protected] 67 / 213

Page 73: Macro Expert Manual

Display Message Dialog

Display a message dialog for informing something or asking the user to make a choice. As anexample, you can insert a Message Dialog action to give user a chance whether to execute theshutting down action before it actually is performed.

Parameters

Message to display This message will be shown in the dialog.

Title 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 thebutton is clicked.

Button selected by default Specifies a button which is as default button, the defaultbutton will be focused when the dialog shows.

Press the default button after X seconds Specifies the number of seconds to waitbefore clicking the default button automatically.

Return result to variable Specifies the name of an already defined variable thatshould be populated with the button that has been clicked. The return value is a string,it can be one of the following:

OKCANCELYESNOABORTRETRYIGNORE

Help for Macro Expert Display Message Dialog

[email protected] 68 / 213

Page 74: Macro Expert Manual

Select a folder

Select a folder for subsequent actions. For example, you may utilize the instruction to selectthe source folder or destination folder in a file copying task.

Parameters

Title of dialog The title of dialog, it will be displayed in the dialog box, and can beused 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 whenthe dialog popups.

Do not show network folder Specifies whether to include network folders below thedomain level in the dialog box.

Action after clicking "Cancel" button Specifies an action that should be executed afterthe "Cancel" button is clicked.

Retrieve path of folder into variable Specifies the name of an already definedvariable 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".

Help for Macro Expert Select a Folder

[email protected] 69 / 213

Page 75: Macro Expert Manual

File-selection Dialog

Displays file-selection dialog for a file name. The action can be used for asking a file nameduring a macro is playing back.

Parameters

Type 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 namefield when the dialog shows.

Initial folder Specifies a path to be the initial directory. If Initial file name contains apath, 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 toseparate the patterns (for example, "*.TXT;*.DOC;*.BAK"). A pattern string can be acombination of valid file name characters and the asterisk (*) wildcard character. Donot 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 thatshould 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".

Help for Macro Expert File-selection Dialog

[email protected] 70 / 213

Page 76: Macro Expert Manual

Input dialog

Displays an input dialog box that lets the user enter a value, the entered value will be used inthe subsequent actions. For example, you may use the instruction to ask user which type offiles 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 beused 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 optionis "Only numeric is allowed" and the user enter a string "abc", an error message boxwill popup when "OK" button is clicked.

Value must not be empty W ith the option checked, the "OK" button will be grayed ifthere 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 afterthe "Cancel" button is clicked.

Store entered value into Specifies the name of an already defined variable thatshould 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 variableand data type, please refer to "Variable and Expression".

Help for Macro Expert Input Dialog

[email protected] 71 / 213

Page 77: Macro Expert Manual

Show Tips Text

Displays a window and show the tips text. The instruction is useful before a long-timeoperation is about to go. You also use it to inform the user something.

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

Title 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 thewindow automatically. If the option is checked, the window will be closedautomatically. Otherwise, the windows must be closed by the action "Hide Tips Text".

Text window position is relative to Specifies the position of the left-top corner of thewindow, it can be one of the following.:

Relative to the screenRelative to the foreground windowRelative to the current cursor positionCenter in the screen

Window Size Specifies the size of the window.

Help for Macro Expert Show Tip Text

[email protected] 72 / 213

Page 78: Macro Expert Manual

Hide Tip Text

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

Help for Macro Expert Hide tip text

[email protected] 73 / 213

Page 79: Macro Expert Manual

Choice dialog

Displays a multiple choice dialog box that prompts user for a choice. It's useful when the usermust 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 beused 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 comboboxDroplistList boxRadio optionCheck box

Items Specifies the items for multiple selection. Each item should be separated by thesemicolon characters.

Initial value Specifies a default value.

Return value-type Specifies to return whether the text of the selected item or its 0-based index number.

Populate variable with result Specifies a variable to store the selected item. Multiple-selection will be separated by the semicolon characters.

Action after clicking "Cancel" button Specifies an action that should be executed afterthe "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 thelist.

Press OK button after x seconds Specifies whether to automatically press the OKbutton.

Notes:

The variable for selected items shouldn't be empty, for more information about the variable anddata type, please refer to "Variable and Expression".

Help for Macro Expert Choice Dialog

[email protected] 74 / 213

Page 80: Macro Expert Manual

Window Actions

Shows, closes, activates, resizes, moves a specified window.

Parameters

Which window Specifies a window to be manipulated. Please see the "Which W indow"

Action Specifies an action that should be applied to the window. The action can be oneof the following:

ActivateShows the window and brings it to the front.

CloseSends a request to the windows for closing.

MoveChanges the position of the specified window.

HideHides the window and activates another window.

ShowActivates the window and displays it in its current size and position.

TopmostPlaces the window to above all windows.

Cancel topmostPlaces the window to behind all topmost windows.

ResizeChanges the dimensions of the specified window.

MaximizedActivates the window and displays it as a maximized window.

MinimizedActivates the window and displays it as a minimized window.

RestoreActivates and displays the window. If the window is minimized or maximized, itwill be restored to its original size and position.

OpacitySets the window transparent level (0-255), the value 0 will hide the window.

Find windowSearches 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, thewindow 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.

Help for Macro Expert Window action

[email protected] 75 / 213

Page 81: Macro Expert Manual

Delay

Waits for some milliseconds, seconds, minutes or hours. It holds the execution of macro untilthe time is elapsed.

Parameters

Delay to wait for Specifies a time value for waiting.

Help for Macro Expert Delay

[email protected] 76 / 213

Page 82: Macro Expert Manual

Wait for a window

Pauses the execution of macro until a specific window is existed, focused or etc. If the windowexists, 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:

existednot existedfocusednot focused

Window action If the window is existed, you can add an action to it, it can be one ofthe following:

noneshowmaximizedminimizedrestore

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 alwayssucceeds.

Help for Macro Expert Wait for a window

[email protected] 77 / 213

Page 83: Macro Expert Manual

Wait for Color

Suspends the playback until the specified color of pixel changes to the given color, or to anyother color. It's very useful to wait completing an action on an application, because in most ofcase 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 colorpixel color is not sam as specified colorpixel 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 coordinatesAbsolute coordinates, start from the top-left of the screen.

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

Relative to the current positionRelative 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 exactlyor similarly.

Tolerance 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 andcolor. Just moves the mouse pointer to the right box and drags it to the desiredposition, and then releases the mouse key.

Picked by Hotkey Clicks the button to enter the picking state, and simply moves themouse 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 Matchcolor value exactly

Help for Macro Expert Wait for color

[email protected] 78 / 213

Page 84: Macro Expert Manual

Wait for Keystroke

Pauses the execution of macro until a specific key is pressed.

Parameters

Keystroke combination Specifies which key or key combination to be waited, leavingthe field blank indicates to wait for pressing any key.

Which window should be topmost Specifies a window limition for the keystroke. Itdoes mean to pause the execution of the macro until the specific window has the focusand 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".

Help for Macro Expert Wait for keystroke

[email protected] 79 / 213

Page 85: Macro Expert Manual

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.

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 ofthe mouse cursor.

Notes:

For time-out options, please refer to "Time out".

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

Help for Macro Expert Wait for mouse motion

[email protected] 80 / 213

Page 86: Macro Expert Manual

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".

Help for Macro Expert Wait for file

[email protected] 81 / 213

Page 87: Macro Expert Manual

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.

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 isrunning or not.

Return full path name of process into variable Specifies the variable to receive thefull path name of the process.

Notes:

For time-out options, please refer to "Time out".

Help for Macro Expert Wait for process

[email protected] 82 / 213

Page 88: Macro Expert Manual

On Error

Specifies how to do when an error occurs. W ithout an On Error action, any error will cause theexection stops.

Parameters

When an error occurs Specifies how to do when an error ocuurs. It can be one of thefollowing:

Stop playbackIngore the error and continueGoto

Beep when an error occurs Specifies whether to alarm the user when an error occursduring playback.

Play an audio file Specifies a wav file to play instead of the simple tones on thespeaker.

Note:

This instruction can only affect the subsequent steps.

Help for Macro Expert On Error

[email protected] 83 / 213

Page 89: Macro Expert Manual

Play Control

Pause

Indicates to pause the execution of macro until the user resumes.

Stop

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 playback.

Adjust speed

Adjusts the level of the playing speed, between -10 to 10(-10 is the slowest and 10 isthe fastest).

Help for Macro Expert Play speed

[email protected] 84 / 213

Page 90: Macro Expert Manual

Play a Macro

Play a macro. The instruction is useful for reusing code so the same task does not have to bewritten over and over again.

Parameters

Macro is in macro folder Specifies a script file in the macro folder, the path will beconverted 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 ignorethe 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 iscompleted" 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 inthe macro folder, so when the entire macro folder moves to a new position, the macroplayer still locate the script file.

Help for Macro Expert Play a macro

[email protected] 85 / 213

Page 91: Macro Expert Manual

Set emulation level

Sets the emulation level for the mouse and keyboard activity. The level can be normal level orlow-level level. For the low-level, MacroPlayer will emulate the mouse and keyboard actions byaccessing the hardware. This will ensure the activity to be played correctly in the most ofgames.

Notes:

This action will only influence the subsequent actions. If you'd like to set the emulation typefor the range to the entire script, please set the option on the play option dialog.

Help for Macro Expert Set emulation level

[email protected] 86 / 213

Page 92: Macro Expert Manual

Block/unblock mouse and keyboard

Block

Block the mouse and keyboard, real physical input from the mouse or keyboard will notaffect.

Unblock

Enable the mouse and keyboard.

Notes:

Pressing Ctrl+Alt+Del will re-enable the mouse and keyboard.

Help for Macro Expert Block/unblock mouse and keyboard

[email protected] 87 / 213

Page 93: Macro Expert Manual

Log a playback message

Write a message into the playback log file.

Parameters

Content Specifies the content

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 filedepend on the log level of the macro.

Write message in debug mode (play in Macro Editor) W ith this option checked if thecontent is only for the debugging purpose. To play the macro in the debug mode, openthe script file in the Macro Editor, then click menu "Play".

Help for Macro Expert Log a Playback Message

[email protected] 88 / 213

Page 94: Macro Expert Manual

Increase/Decrease value

Increase or decrease the value of the variable by a step value.

Parameters

Step value Specifies the value of step for increasing the value of the variable. Thestep value must be a number.

Increase/decrease first character for string The option is useful toincrease/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 asnumber 0.

Help for Macro Expert Increase/Decrease value

[email protected] 89 / 213

Page 95: Macro Expert Manual

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 thevariable without any preprocessing.

Convert value to Specifies how to store the variable, it can be the following:

String valueNumberic valueDatetime valueBinary value

Notes:

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

Help for Macro Expert Set value

[email protected] 90 / 213

Page 96: Macro Expert Manual

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 theinstruction "Call an External DLL". The user uses the instruction to initialize the variable whichwould 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 variableClears the content in variableStores as string valueStores as number valueStores as datetime valueStores 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 willstore into the variable without any preprocessing.

Reallocate variable space Specifies the new size for the variable's buffer, it expendsthe buffer automatically. If the size less than the current data size, the rest data willbe truncate.

Set data size as well Specifies the new size of the variable data. The option is usefulwhen the variable is used to retrieve the data from an exteran DLL API because themost 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 thevariable's buffer automatically extends to fit the size of the content. W ith the optionchecked, 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 thisapplication, each character nestling snugly into two bytes (UNICODE) of storage andthe unit of string value is the character. W ith the option checked, the unit ofparameters in this instruction will treat as the byte.

Syntax of expression

1. String valueThe content should be a standard expression.

2. Datetime valueThe content must be quoted by the number sign '#', for example: #2007-01-01 08:30#.

3. Number valueSupports 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>;...

Help for Macro Expert Advanced Set Variable Value

[email protected] 91 / 213

Page 97: Macro Expert Manual

<Data type code>:<content n>;

Code of DataType

ShortCode

DataType Description

Integer I Integer 2 bytes, the hexadecimal notation 0x is supported.

Long L Long 4 bytes, the hexadecimal notation 0x is supported.

Byte B Byte 1 bytes, the hexadecimal notation 0x is supported.

String[length] S[length] Text inDBCS

The member's size will be determined by the optionallength or the actual size of the content.If the character space is included in the text, the textmust be quoted by the single or double quotation marks.In this case, the quotation marks could be represented by\' or \".

WString[length] W[length] Text inUnicode

Date DDateandtime

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

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 alignedon natural boundaries.

Help for Macro Expert Advanced Set Variable Value

[email protected] 92 / 213

Page 98: Macro Expert Manual

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, aftercalling function in an external DLL, the return result will be stored as a structural data mannerin the variable's buffer. You have to use this instruction to retrieve the member value from thebuffer.

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, inbytes or characters.

Limit block size of reading Specifies whether to limit the amount of the content, inbytes or characters.

In bytes W ith the option unchecked, it reads the content in characters for the stringtype.

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 mustcheck this option to convert it into UNICODE.

Note:

The offset position is the key for reading the member value correctly, and you have tocompute the right value before using the instruction.

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

Help for Macro Expert Advanced Get Variable Value

[email protected] 93 / 213

Page 99: Macro Expert Manual

Redefine Variable

Redefines the variable.

Parameters

Variable name Specifies the name of the variable to be redefined.

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 thefollowing:

Does not change the data in variableClear the data in variableString valueNumber valueDate/time value

Initial value Specifies the variable value.

Variable value is plain-text Specifies whether to evaluate the initial value as anexpression. 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.

Help for Macro Expert Redefine Variable

[email protected] 94 / 213

Page 100: Macro Expert Manual

Convert Text

Converts the text into lower case, upper case, or capitcal letter.

Parameters

Text Specifies the text to be converted.

Convert method Specifies how to conver the text.

Populate variable with converted text Specifies a variable to hold the convertedstring.

Note:

About the variable, please refer to "Variable and Expression"

Help for Macro Expert Convert Text

[email protected] 95 / 213

Page 101: Macro Expert Manual

Pad Text

Pads the text with the specified content.

Parameters

Text Specifies the text expression to be search.

Padding position Specifies the padding location, it can be begin, end, and both beginand end.

Text 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 xnumber 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"

Help for Macro Expert Pad Text

[email protected] 96 / 213

Page 102: Macro Expert Manual

Split Text

Splits the text and store the sub strings into an array.

Parameters

Text Specifies the text to be splitted.

Separator character Specifies the character to be used to delimit the substring in thetext.

Populate array with substrings Specifies the name of the variable/array, the variablewill be redefined to fit the splitted result.

Populate variable with amount of substrings Specifies the name of the variable tostore the amount of the substrings. It also to be the size of the array.

Note:

About the variable, please refer to "Variable and Expression"

Help for Macro Expert Split Text

[email protected] 97 / 213

Page 103: Macro Expert Manual

Trim Text

Trims the whitespace from the text.

Parameters

Text Specifies the text to be trimmed.

Convert method Specifies how to trim the text.

Populate variable with trimmed text Specifies a variable to hold the result string.

Note:

About the variable, please refer to "Variable and Expression"

Help for Macro Expert Trim Text

[email protected] 98 / 213

Page 104: Macro Expert Manual

Find Text

Searches and extracts a substring in a text.

Parameters

Text Specifies the text expression to be search.

Start position Specifies the The zero-based index of the first character in this CStringTobject 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 optionunchecked, you may also use wildcards such as asterisks (*) and question marks (?) insearch 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 startposition, 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 athttp://en.wikipedia.org/wiki/Regular_expression.

About the variable, please refer to "Variable and Expression"

Help for Macro Expert Find Text

[email protected] 99 / 213

Page 105: Macro Expert Manual

Replace Text

Searches and replaces a substring in a text.

Parameters

Text for replacing Specifies the text will be searched and replaced.

Start position Specifies the The zero-based index of the first character in this CStringTobject 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 thevariable, 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 allmatched.

Use regular expression Specifies whether to use regular expression. W ith this optionunchecked, you may also use wildcards such as asterisks (*) and question marks (?) insearch string.

Populate variable with number of substitutions made If the sub string (pattern) isnot found, return value is 0.

Populate variable with next start position Specifies a variable to hold the next startposition, 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 athttp://en.wikipedia.org/wiki/Regular_expression.

About the variable, please refer to "Variable and Expression"

Help for Macro Expert Replace Text

[email protected] 100 / 213

Page 106: Macro Expert Manual

Format Datetime

Converts a datetime value to the text.

Parameters

Datetime Specifies the datetime value.

Format string type Specifies how to format the datetime, it can use the systemdefault format string.

Date format string Specifies the format string for the date part, it can be "none" toignore the date part of the datetime.

Time format string Specifies the format string for the time part, it can be "none" toignore the time part of the datetime.

Populate variable with converted text Specifies a variable to hold the convertedstring.

Note:

The below tablie lists the notations to be used to specify how dates and times aredisplayed:

Time notations Displays

h Hour (hh displays the hour with a leading zero)

m Minute (mm displays the minute with a leading zero)

s Second (ss displays the second with a leading zero)

tt A.M. or P.M.

h 12 hour time display (hh displays the hour with a leading zero)

H 24 hour time display (HH displays the hour with a leading zero)

Date notationsThis Displays

d Day (dd displays the day with a leading zero)

dddd Day of the week

M Month (HH displays the month with a leading zero)

MMMM Full month name

yy Year in short format

yyyy Year in long format

Help for Macro Expert Fomat Datetime

[email protected] 101 / 213

Page 107: Macro Expert Manual

Comment

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

Help for Macro Expert Comments

[email protected] 102 / 213

Page 108: Macro Expert Manual

Separator Line

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

Help for Macro Expert Separator line

[email protected] 103 / 213

Page 109: Macro Expert Manual

Label

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

Help for Macro Expert Label

[email protected] 104 / 213

Page 110: Macro Expert Manual

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.

Help for Macro Expert Goto

[email protected] 105 / 213

Page 111: Macro Expert Manual

If Variable

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

If the logical expression evaluates to 'FALSE' and 'Else ' included, any steps after 'Else ' andbefore 'End If' are Played.

If the logical expression evaluates to 'FALSE' and 'Else ' not included, Macro Player will gotothe 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, Notequal, 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 andlowercase 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, MacroPlayer will be applied to the following evaluation rule:

Operator Rule

Equal If the option 'As a string' is checked, Macro Player considersthe value as a string and then to evaluate the logicalexpression, otherwise, Macro Player will convert the value tonumber 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 Playerdirectly compares "12.05" and "12.0500" and get the resultFALSE.

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", theresult 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 logicalexpression "0 less than 34", the result will be TRUE.

Greaterthan Sames as Less than

Contain 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 theresult TRUE.

Help for Macro Expert If variable

[email protected] 106 / 213

Page 112: Macro Expert Manual

Notcontain Sames as Contain

Help for Macro Expert If variable

[email protected] 107 / 213

Page 113: Macro Expert Manual

If Color

Conditionally play a set of steps based on the value of a pixel's color. If the color value meetsthe criteria, any steps following 'If Color' and preceding 'Else ' or 'End If' (whichever occursfirst) are played.

Parameters

Compare type: Specifies how to compare the pixel color, it can be the following:

pixel color is sam as specified colorpixel color is not sam as specified colorpixel color is changed

Within X seconds For "Pixel color is changed" only, it specifies the number of secondsto 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 coordinatesAbsolute coordinates, start from the top-left of the screen.

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

Relative to the current positionRelative 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 exactlyor similarly.

Tolerance Specifies the tolerance value for the case of Match color value exactly isnot (unchecked).

Pick coordinates and color (Capture tool) A tool for picking position coordinates andcolor. 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 themouse pointer around the target position and then press the hotkey.

Notes:

The tolerance value must be a number from 1 to 255.

Help for Macro Expert If color

[email protected] 108 / 213

Page 114: Macro Expert Manual

If File Exists

Conditionally play a set of steps based on the specified file/folder's state. If the logicalexpression 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.

Help for Macro Expert If File Exists

[email protected] 109 / 213

Page 115: Macro Expert Manual

If Window Exists

Conditionally play a set of steps based on the specified window's state. If the logicalexpression 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 thehandle of matched window.

Help for Macro Expert If Window Exists

[email protected] 110 / 213

Page 116: Macro Expert Manual

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 amatching End Select action.

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

Help for Macro Expert Select Case

[email protected] 111 / 213

Page 117: Macro Expert Manual

Loop

Play a set of steps(steps block) quoted with the instruction 'Loop' and 'End loop' for a numberof 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 completetimes of loop.

B. Continuous loop

Parameters

Variable for intermedial counter value Specifies a variable to store the completetimes 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 theloop.

Variable for intermedial counter value Specifies a variable to store the intermedialcounter 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 stringbefore evaluating.

Note:

In the case 'Loop through a range ', you may specify the 'step value ' less than the number 0to decrease the counter value each time the loop repeats.

Help for Macro Expert Loop

[email protected] 112 / 213

Page 118: Macro Expert Manual

Loop Windows

Loops through all of the windows that are currently opened on the system.

Parameters

Search type Specifies how to search the windows.

Include mask Specifies the include mask. It can include multiple masks separated bysemicolons(;). For example, the include mask *pad;*Explorer; specifies to include allwindow titles ending with the text Explorer or pad in the title.

Exclude mask Specifies the wildcard mask for windows that should be excluded fromthe loop.

Allow hidden windows Specifies whether to search the hidden windows. Multiplemasks 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 populatedwith the handle of the window on each successive loop.

Store text of window into (Optional) Specifies a variable that should be populatedwith the window text on each successive loop.

Note:

The window handle is a special number value that W indows System assigns to a window eachtime it is created.

Help for Macro Expert Loop Windows

[email protected] 113 / 213

Page 119: Macro Expert Manual

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.

Include mask Specifies the include mask. It can include multiple masks separated bysemicolons(;). For example, the include mask *.txt;*.bmp; specifies to include all filesthat have the extension txt or bmp.

Exclude mask Specifies the wildcard mask to exclude the files from the loop. It caninclude multiple masks separated by semicolons(;).

Include folders Specifies whether to include the folders.

Include subfolders Specifies whether the search extends to the subfolders of theSource folder.

Match case Specifies whether searching is case-sensitive or not.

Store file name into (Optional) Specifies a variable that should be populated with thefile name on each successive loop.

Do not include path (filename only) Specifies whether to return the path informationof the file.

Note:

You could filter files based on the attribute settings of the source files. For more information,please refer to Attributes Filter.

Help for Macro Expert Loop Files

[email protected] 114 / 213

Page 120: Macro Expert Manual

Loop Processes

Loops through all of the process ran on system, or all of the modules contained in specifiedprocess.

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 searchthe 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 bysemicolons(;). For example, the include mask *er.exe; specifies to include allprocesses/modules that name are ended with the text er.exe.

Exclude mask Specifies the wildcard mask to exclude the processes/modules from theloop. It can include multiple masks separated by semicolons(;).

Return process ID/module handle into (Optional) Specifies a variable that should bepopulated 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 withthe file name of the process or module on each successive loop.

Do not include path (filename only) Specifies whether to return the path informationof the file.

Help for Macro Expert Loop Processes

[email protected] 115 / 213

Page 121: Macro Expert Manual

Loop Control

Continue Loop

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 beplaced anywhere between 'Loop' and 'End Loop'.

Help for Macro Expert Loop Control

[email protected] 116 / 213

Page 122: Macro Expert Manual

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 theparameters 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 ordocument is opened.

Return main window into Specifies a variable for storing the handle value of the mainwindow. If the program does not have a window (a console program for example), thevalue 0 will be returned.

Help for Macro Expert Run

[email protected] 117 / 213

Page 123: Macro Expert Manual

End Process

Kill the instances of running process. This action will get any data changes made in theprocesses lost.

Parameters

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 processlimit in an account.

If more than one maching process is found Specifies how to deal with the multi-instances of running process.

Force to terminate process When enabled, the process will not be given the chanceto save its state.

Help for Macro Expert End Process

[email protected] 118 / 213

Page 124: Macro Expert Manual

Image search

Searches the specified image in the specified area on the screen, and then carry out a mousemotion at the position. The position coordinates value X and Y could be retrieved for thesubsequent 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 thecolor 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 "Text search based on image" to retrieve the position ofa string appeared on the screen.

Help for Macro Expert Image search

[email protected] 119 / 213

Page 125: Macro Expert Manual

Text search based on image

Searches a text on the screen, and then carry out a mouse move or click action. The text firstwill be converted into an image, and then the searching routine searches for the image in thespecified area on the screen. If a match is present, the X and Y coordinates could be retrievedfor the subsequent actions as well. Unlike the instruction "Image search", you just specify astring rather than a bitmap file.

Parameters

Text to search for Specifies the text should be searched.

Font Specifies the font name, size and other parameters. These parameters should beconsistent 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.

Help for Macro Expert Text earch based on image

[email protected] 120 / 213

Page 126: Macro Expert Manual

Get pixel from point

Retrieves the color value of the pixel at the specified position.

Parameters

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 coordinatesAbsolute coordinates, start from the top-left of the screen.

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

Relative to the current positionRelative 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 colorvalue. The color value will be stored in the number format.

Pick coordinates A tool for picking position coordinates and color. Just move themouse pointer to the right box and drag it to the desired position, and then releasethe mouse key.

Picked by Hotkey Click the button to enter the picking state, and simply move themouse pointer around the target position and then press the hotkey.

Help for Macro Expert Get Pixel from Point

[email protected] 121 / 213

Page 127: Macro Expert Manual

Registry Operation

The registry is a system-defined database in which applications and system components storeand retrieve configuration data. The instruction "Registry Operation" give you an ability tocreate a key, remove a key, create a value item, remove a value item, read a value item andset a value item.

Parameters

Action Type Specifies the operation type, it can be one of the following:

Create a registry keyRemove a registry keyCreate a registry valueRemove a registry valueRead a registry valueWrite a registry valueRemove 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 moreinformation about the variable, please refer to "Variable and Expression"

Remove all sub-keys and values Specifies whether to remove all sub-keys and valuesunder the registry key, if the option is unchecked and the registry key includes one ormore subkeys then the operation will fail.

Data type of value Specifies the data type of the registry value, it can be one of thefollowing.:

String valueNumeric 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 namefield blank.The difference bwteen "Remove all subkeys and values" and "Remove a registrykey" is the action "Remove a registry key " will remove the registry key self.

Help for Macro Expert Registry Operation

[email protected] 122 / 213

Page 128: Macro Expert Manual

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 thefunction.

Function arguments Specifies the arguments list of calling function.

Store return value into Specifies a variable for storing the return value of calling thefunction.

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>;

Parameter-type Code

ShortCode Data Description

Integer I Integer 2 bytes, the hexadecimal notation 0x is supported.

Long L Long 4 bytes, the hexadecimal notation 0x is supported.

Byte B Byte 1 bytes, the hexadecimal notation 0x is supported.

String S Text inDBCS

If the character space is included in the text, the text must bequoted by the single or double quotation marks. In this case, thequotation marks could be represented by \' or \".

WString W Text inUnicode

Date DDateandtime

16 bytes (same as SYSTEMTIME in W indows API), the contentshould be quoted by the number sign '#'.

Pointer P Pointer

4 bytes, a pointer to the buffer of a variable. The content mustbe a variable name. You can use the instruction "Advanced SetVariable Value" to pre-allocate the memory for the variable, oruse 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";

Help for Macro Expert Call an External DLL

[email protected] 123 / 213

Page 129: Macro Expert Manual

Send a 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 windowprocedure has processed the message or the time is out.

Timeout Specifies the duration, in milliseconds, of the time-out period. The zeroindicates 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 themessage.

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".

Help for Macro Expert Send Message to Window

[email protected] 124 / 213

Page 130: Macro Expert Manual

Get Text from Object

Extracts the text from the specified UI object (user interface object, such as button, menuitem, link and etc.). You could use the instruction to retrieve the content in a text box, thecaption 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 thecontent in the value property, and then return the longer one.

Populate variable with readed content Specifies a variable to which stores thereaded content.

Notes:

For more information about locating a UI object, please refer to "Find a UI object".

Help for Macro Expert Get Text from Object

[email protected] 125 / 213

Page 131: Macro Expert Manual

Get Text from Point

Extracts the text of the UI object that contains the specified point.

Parameters

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 coordinatesAbsolute coordinates, start from the top-left of the screen.

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

Relative to the current positionRelative 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.

Text from Specifies how to gather the text. If the "Auto-Detect" is selected, MacroPlayer will compare the content in the name property of the UI object and the contentin 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 standardwindows 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 "Which W indow", please refer to "Locate awindow".

Help for Macro Expert Get Text from Point

[email protected] 126 / 213

Page 132: Macro Expert Manual

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.

Allow new number to be same as last one Specifies whether to generate a differentnumber to the last.

Store number into variable Specifies the variable's name which should be populatedwith the number.

Notes:

If the maximum number same as or less than the minimum number, the same number will begenerated every time.

Help for Macro Expert Generate Random Number

[email protected] 127 / 213

Page 133: Macro Expert Manual

Carry out action on Object

Performans an action on a UI object (user interface object, such as the button, menu item, linkand etc.).

Parameters

Carry out action Specifies the action, it can be the following:

Set focusSets the focus to the object.

Performs object's default action Carries out the default action of the object. Not all objects have a defaultaction

Add object to the current selectionAdds the object to the current selection. Not all objects support this operation.

Remove object to the current selectionRemoves the object to the current selection. Not all objects support thisoperation.

Notes:

For more information about locating a UI object, please refer to "Find a UI object".

Help for Macro Expert Carry out Action on Object

[email protected] 128 / 213

Page 134: Macro Expert Manual

Logoff and Lock workstation

Logoff

Shuts down all running applications, then it logs the current user off.

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.

Help for Macro Expert Lock workstation

[email protected] 129 / 213

Page 135: Macro Expert Manual

Start out the Screen-Saver

Executes the screen saver application.

Notes:

If there is no screen saver set, the instruction will be ignored.

Help for Macro Expert Start Screen-Saver

[email protected] 130 / 213

Page 136: Macro Expert Manual

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

Attempts the computer to enter the sleep state. This action depends on the computerhardware, 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, ifthe 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 afterall running applications are closed, if one of these applications failed to close, shuttingdown or restarting aborts.

If this option is checked, shutting down or restarting computer will take placeimmediately regardless of whether all running applications are closed, it may causesome applications to lose data.

Help for Macro Expert Shut down computer

[email protected] 131 / 213

Page 137: Macro Expert Manual

Turn on/off Monitor

Soft off/on the monitor.

Turn off monitor

Shuts off the monitor.

Turn on monitor

Activates the monitor.

Help for Macro Expert Turn off/on Display

[email protected] 132 / 213

Page 138: Macro Expert Manual

Copy, Cut, Paste and Clear

Copy, Cut and Paste

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

Clear

Deletes the contents of the clipboard.

Help for Macro Expert Copy, Cut, Paste and Clear

[email protected] 133 / 213

Page 139: Macro Expert Manual

Put a text to the clipboard

Stores a text to the clipboard.

Parameters

Put text to clipboard Specifies a string to which stores into the clipboard.

Notes:

The size length of text should not be exceed 32000.

Help for Macro Expert Put a text to the clipboard

[email protected] 134 / 213

Page 140: Macro Expert Manual

Get the text from clipboard

Copy the current content of the clipboard into a variable.

Parameters

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

Help for Macro Expert Get the text from the clipboard

[email protected] 135 / 213

Page 141: Macro Expert Manual

Play an audio

Play a sound or a music file.

Parameters

The audio file Specifies a file that you'd like to play.

Wait until the audio completes playback If this option is checked, it will pause theexecution of macro until the audio playing is completed, and otherwise, it will executesubsequent actions immediately.

Notes:

The playing is based on W indows Media Player 6.4 or above.

Help for Macro Expert Play an audio

[email protected] 136 / 213

Page 142: Macro Expert Manual

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%.

Help for Macro Expert Increase/Decrease Volume

[email protected] 137 / 213

Page 143: Macro Expert Manual

Adjust volume

Adjusts the volume of specified sound device on the computer.

Parameters

Device Specifies a device that you'd like to adjust. It can only be "Master" for W indowsVista or later.

Volume Drags the slider right to increase the volume, or left to decrease the volume.

Help for Macro Expert Adjust volume

[email protected] 138 / 213

Page 144: Macro Expert Manual

Sound Switch

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

Parameters

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.

Help for Macro Expert Sound Switch

[email protected] 139 / 213

Page 145: Macro Expert Manual

Sound On/Off

Specifies whether the sound device is muted or not.

Parameters

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.

Help for Macro Expert Sound on/off

[email protected] 140 / 213

Page 146: Macro Expert Manual

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 thefollowing.

PlayPauseResumeStopSkip next trackSkip previous trackOpen the door of CDClose the door of CD

Notes:

As usual, The default CD driver is the first CD driver.

Help for Macro Expert CD Player

[email protected] 141 / 213

Page 147: Macro Expert Manual

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, orprompts user for some stuff. This may cause the execution of script to stop until the user clicksa 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 todeal with the file button on the page.

Parameters

This rule just applies to Specifies which popup window this rule will apply for. Aboutthe window index number, please see the note below.

When window pops out Specifies which button should be clicked automatically. It canbe the one of following:

Do nothingSelect first buttonSelect second buttonSelect third buttonSelect button based on the message in dialog

Before carrying out action, wait for Specifies the time interval for which execution isto be delay.

Automatically place text into text field Specifies the text to be used to fill the textbox in the popup window. The multiple text should be separatred by the \0, forexample: 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 windowcounter will be reset, the index number value will start from 1 again when a popupwindow appears.

Notes:

The window counter maintains the index number of popup windows, and it's valueincrements each time the popup window appears. Macro Player has two popup windowcounters, the global counter and local counter. The global counter always avaiableand increments for every popup window on the webpage. The local counter startswhen 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 thatrule is for the local counter only.

The instruction can only work for the script popup window but the inner-window whichis implement by the div style or other skills.

Help for Macro Expert On Popup Window on Webpage

[email protected] 142 / 213

Page 148: Macro Expert Manual

Open a Web page

Opens the specified web page in the default browser.

Parameters

The Address(URL) Specifies the web page or URL that should be opened. The webpage will be opened in the default browser.

Open method Specifies how to open the URL, it can be general, open in newwindow 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 webpagerelated actions to distinguish among several webpages.

Don't close connected page before opening If the target page name has been usedand connected to a webpage, specifies whether to close the connected page beforeopening.

Open it in Microsoft Internet Explorer Specifies whether to open it in MicrosoftInternet Explorer or the internal browserzs. Generally, the internal browser will givemore performance.

Close page at end of playback Specifies whether to automatically close the openedpage when the playback complete.

Return URL into variable Specifies a variable to hold the actual URL after the pageopened.

Notes:

A script window may cause that player wait until user responds it. To click the buttonautomatically 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".

Help for Macro Expert Open a Web page

[email protected] 143 / 213

Page 149: Macro Expert Manual

Connect a Opened Webpage

Connects a opened webpage. This is required if you'd like to perform some actions(filling pageform or navigating on the webpage) on the webpage. The instruction will also be used toconnect 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 thesearch content.

Close page at end of playback Specifies whether to close the page at the end ofplayback of the macro.

Close page before connecting Specifies whether to close the page before connectinganother one using the same page name.

After connecting Specifies whether to wait the content of page to completedownloading.

Page name Specifies a name to the webpage, the page name used to distinguish awebpage among the Webpages.

Return URL into variable Specifies the name of the variable to which stores the URLof the page.

Help for Macro Expert Connect a Opened Webpage

[email protected] 144 / 213

Page 150: Macro Expert Manual

Close a Opened 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 instructionwill 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 whenclosing the page. The option "Quit Internet Explorer" will be ignored if the webpageis not opened by Internet Explorer.

Notes:

An error will throw if the specified webpage is not connected or opened when executing theaction.

Help for Macro Expert Close Webpage

[email protected] 145 / 213

Page 151: Macro Expert Manual

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 orconnected before executing this action.

Locate element by its path in page Specifies the element path in the page. Forexample: 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 matchedelements collection when more than one elements meet the criteria.

Searching in main frame Specifies whether to search for the element in themain frame in the webpage.

Frame name must be Specifies the frame name if searching for the element ina specified frame.

Index of frames that match criteria If more than one frames have the samename, specifies the index of the frames collection.

Form name must be Specifies the form name if searching for the element in aspecified form.

Index of forms that match criteria If more than one forms have the samename, specifies the index of the forms collection.

Element attributes Specifies an attributes filter for the searching, using thestandard 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 thatmatch 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 inner textRead inner HTMLRead attribute valueRead 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.

Help for Macro Expert Read Field

[email protected] 146 / 213

Page 152: Macro Expert Manual

Fill a Field in Webpage

Fills a field on Webpage.

Parameters

Page name Specifies which page will be read. The webpage should be opened orconnected before executing this action.

Locate element by its path in page Specifies the element path in the page. Forexample: 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 matchedelements collection when more than one elements meet the criteria.

Searching in main frame Specifies whether to search for the element in themain frame in the webpage.

Frame name must be Specifies the frame name if searching for the element ina specified frame.

Index of frames that match criteria If more than one frames have the samename, specifies the index of the frames collection.

Form name must be Specifies the form name if searching for the element in aspecified form.

Index of forms that match criteria If more than one forms have the samename, specifies the index of the forms collection.

Element attributes Specifies an attributes filter for the searching, using thestandard 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 thatmatch 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 theinner text of the element. For some WYSIWYG pages, you have to set this optionchecked to fill the POST area. Because it is not a standard input element in this kindpage.

Notes:

If the element is not a standard input element, you must to use the option "Force to fillvalue into element".

For the checkbox, you can use the number 1 or text true to check it.

Help for Macro Expert Fill Field

[email protected] 147 / 213

Page 153: Macro Expert Manual

Click Element

Searches the webpage for the element that matches the specified criteria, and then simulatesa click on it.

Parameters

Page name Specifies which page will be read. The webpage should be opened orconnected before executing this action.

Locate element by its path in page Specifies the element path in the page. Forexample: 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 matchedelements collection when more than one elements meet the criteria.

Searching in main frame Specifies whether to search for the element in themain frame in the webpage.

Frame name must be Specifies the frame name if searching for the element ina specified frame.

Index of frames that match criteria If more than one frames have the samename, specifies the index of the frames collection.

Form name must be Specifies the form name if searching for the element in aspecified form.

Index of forms that match criteria If more than one forms have the samename, specifies the index of the forms collection.

Element attributes Specifies an attributes filter for the searching, using thestandard 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 thatmatch 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".

Help for Macro Expert Click Element

[email protected] 148 / 213

Page 154: Macro Expert Manual

Find Element on a Webpage

Searches the webpage for the element that matches the specified criteria. You can also usethis action to gather the display text of the element.

Parameters

Page name Specifies which page will be read. The webpage should be opened orconnected before executing this action.

Locate element by its path in page Specifies the element path in the page. Forexample: 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 matchedelements collection when more than one elements meet the criteria.

Searching in main frame Specifies whether to search for the element in themain frame in the webpage.

Frame name must be Specifies the frame name if searching for the element ina specified frame.

Index of frames that match criteria If more than one frames have the samename, specifies the index of the frames collection.

Form name must be Specifies the form name if searching for the element in aspecified form.

Index of forms that match criteria If more than one forms have the samename, specifies the index of the forms collection.

Element attributes Specifies an attributes filter for the searching, using thestandard 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 thatmatch 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 theresult (the number 1 or 0).

Set keyboard focus to element Specifies whether to set the cursor focus to theelement.

Read what Specifies the content to be read, it can be one of the following:

Don't read contentRead inner textRead inner HTMLRead attribute valueRead user typed value

Notes:

Help for Macro Expert Find Element

[email protected] 149 / 213

Page 155: Macro Expert Manual

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".

Help for Macro Expert Find Element

[email protected] 150 / 213

Page 156: Macro Expert Manual

Submit a Form on Webpage

Simulates a submission on Webpage.

Parameters

Page name Specifies which page will be read. The webpage should be opened orconnected before executing this action.

Which form Specifies how to locate the target form, it can be one of the folowing:

Locate form by nameLocate form by IDLocate form by attributies

Form name Specifies the form name, if the target form is a noname form, leaves thefield 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 thefield blank, and uses the option Index of forms that match criteria.

Form attributes Specifies the attributes string for searching the form, it must fit thespecification of HTML. For example : id="abc" method="get"

Index of forms that match criteria Specifies the index number of the forms collectionif there are more than one forms match the searching criteria.

After submitting Specifies whether to wait the content of page to completedownloading.

Return URL into variable Specifies the variable to hold the URL after submitting.

Notes:

For more information about the timeout, please refer to "Timeout".

Help for Macro Expert Submit Form

[email protected] 151 / 213

Page 157: Macro Expert Manual

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 orconnected 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 thecontent in.

Save HTML 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 ifthe 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:

When saving all frames, and the option "Save HTML source" is checked, every frame willstore into the separated file, and excepts the file of the main frame, the other files' namewill be added a sort number , file_0, file_1, file_2 and etc..

Help for Macro Expert Save webpage content

[email protected] 152 / 213

Page 158: Macro Expert Manual

Save Image Element

Locates an image element in the webpage and saves it into a file, the action can also save theimage binary data into the variable.

Parameters

Page name Specifies which page will be read. The webpage should be opened orconnected before executing this action.

Locate element by its path in page Specifies the element path in the page. Forexample: 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 matchedelements collection when more than one elements meet the criteria.

Searching in main frame Specifies whether to search for the element in themain frame in the webpage.

Frame name must be Specifies the frame name if searching for the element ina specified frame.

Index of frames that match criteria If more than one frames have the samename, specifies the index of the frames collection.

Form name must be Specifies the form name if searching for the element in aspecified form.

Index of forms that match criteria If more than one forms have the samename, specifies the index of the forms collection.

Element attributes Specifies an attributes filter for the searching, using thestandard 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 thatmatch 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 thespecified by the field Save to file already exists. It can be "Don't save", "Overwriteexisting file", "Save with an unique filename". W ith the option "Save with an uniquefilename", 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 imagedata, in the binary format.

Help for Macro Expert Save Image Element

[email protected] 153 / 213

Page 159: Macro Expert Manual

Navigation Action on Webpage

Performs an action on a Webpage.

Parameters

Page name Specifies the webpage name, it will determine which page the actionapplies on.

Action Type Specifies the action type, it can be one of the following:

GotoRefreshGo backForwardGo homepageStop

Open a URL Specifies how to deal with the URL, it can be opened in a new window, anew tab.

After carrying out Specifies whether to wait the content of page to completedownloading.

Return URL into variable Specifies the variable to hold the new URL if the page's URLchanged after performing the action.

Notes:

For more information about timeout, please refer to "Timeout".

Help for Macro Expert Internet Explorer Navigation Actions

[email protected] 154 / 213

Page 160: Macro Expert Manual

Send Email

Sends an email via SMTP protocol.

Parameters

To Specifies the recipient. Multiple recipients should be separated by the semi-coloncharacter.

From Specifies the sender.

Subject Specifies the subject of the email.

Text body Specifies the email content.

Body from a file Specifies that the content of the message should be filled by aspecified file.

Is HTML 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".

Help for Macro Expert Send Email

[email protected] 155 / 213

Page 161: Macro Expert Manual

HTTP 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.

If file name exists Specifies how to store the file if the file name has been used byanother file. It can be one of the following:

Don't saveOverwrite existing fileSave with a unique file name

Authencation information Specifies the user name and password if authentication isrequired 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 formator 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".

Help for Macro Expert HTTP Download

[email protected] 156 / 213

Page 162: Macro Expert Manual

Ping

Sends a series of packets over a network or the Internet to a specific computer in order togenerate a response from that computer. The action may also retrieve the IP address of thetarget computer.

Parameters

IP address or host name Specifies the target host.

Number of echo requests Specifies the number of echo requests to send.

Time 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, inmilliseconds.

Return IP address into (optional) Specifies a variable for storing the IP address of thetarget computer.

Return packet-loss rate into (optional) Specifies a variable for storing the packet-lossrate.

Note:

If the target host does not allow ICMP echo request, the ping will return nothing.

Help for Macro Expert Ping

[email protected] 157 / 213

Page 163: Macro Expert Manual

Retrieve Internet Time

Retrieves the time value from a remote host, and set the local time.

Parameters

Time server Specifies the remote host which is running the SNTP.

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 timevalue.

Note:

For time-out options, please refer to "Time out".

Help for Macro Expert Retrieve Internet Time

[email protected] 158 / 213

Page 164: Macro Expert Manual

Internet Explorer Actions

Clear Internet Explorer History

Remove all shortcuts to the pages you viewed during this and previous browsingsessions under Internet Explorer.

Delete Internet Explorer Cookies

Remove all the cookies file on your computer. A cookie is a file created by a Web sitethat stores information on your computer, such as your perferences when visiting thatsite.

Delete Temporary Internet Files

Remove all contents of the Temporary Internet Files folder or folders.

Help for Macro Expert Clear Internet Explorer History

[email protected] 159 / 213

Page 165: Macro Expert Manual

Make remote access connection

Establishes a remote access connection by dialing up.

Parameters

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 asADSL), 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, ifconnection fails.

Notes:

The amount of waiting time is 3 seconds before attempting redialing.

Help for Macro Expert Make remote access connection

[email protected] 160 / 213

Page 166: Macro Expert Manual

Disconnect remote access connection

Terminates a remote access connection.

Parameters

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.

Help for Macro Expert Disconnect remote access connection

[email protected] 161 / 213

Page 167: Macro Expert Manual

Connect network resource

Makes a connection to a network resource. The action can redirect a local device to the networkresource.

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 thelocal device.

Return local name into Specifies a variable for storing the local device name when theconnection is ok.

User name/password Specifies the user name and password for making theconnection. You may left the fields blank for using default user name.

Interact with user if failed to authorize Specifies whether to show the dialog forauthorization purpose when connecting the network connection is failed

Network resource should be remembered Specifies whether to remember thenetwork connection. W ith the option checked, the operating system automaticallyattempts to restore the connection when the user logs on.

Note:

For more information about the file and printer sharing, please refer to "W indowsHelp".For more information about the variable, please refer to "Variable and Expression".

Help for Macro Expert Connect network resource

[email protected] 162 / 213

Page 168: Macro Expert Manual

Disconnect network resource

Cancels an existing W indows network connection. You can also use the action to removeremembered network connections that are not currently connected.

Parameters

Local device name Specifies the name of either the redirected local device or theremote network resource to disconnect from.

Force to disconnect Specifies whether the disconnection should occur if there are openfiles or jobs on the connection.

Network resource should be remembered The W indows will not restore thisconnection during subsequent logon operations. (Disconnecting resources using remotenames has no effect on persistent connections.)

Note:

More information about the file and printer sharing, please refer to "W indows Help".

Help for Macro Expert Disonnect network resource

[email protected] 163 / 213

Page 169: Macro Expert Manual

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 arepermitted in the file-name position. Multiple file names may be specified by separating entrieswith a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will haveunpredictable 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 filename 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 notallowed.

Match case

Specifies whether the search finds the source files which names match the case of charactersin 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 andwild cards are not permitted in the name position. It will have unpredictable results, if you usethe 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 theoption is unchecked and the destination folder is not existed either, the action will not bestarted.

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 isunchecked, all of the source files will be copied into the destination folder and it is possible tooccur several files with the same name. As a result these files will be renamed by adding anumber 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

Help for Macro Expert Copy files

[email protected] 164 / 213

Page 170: Macro Expert Manual

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

Help for Macro Expert Copy files

[email protected] 165 / 213

Page 171: Macro Expert Manual

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 arepermitted in the file-name position. Multiple file names may be specified by separating entrieswith a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will haveunpredictable 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 filename 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 notallowed.

Match case

Specifies whether the search finds the source files which names match the case of charactersin 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 andwild cards are not permitted in the name position. It will have unpredictable results, if you usethe 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 theoption is unchecked and the destination folder is not existed either, the action will not bestarted.

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 isunchecked, all of the source files will be moved into the destination folder and it is possible tooccur several files with the same name. As a result these files will be renamed by adding anumber 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

Help for Macro Expert Move files

[email protected] 166 / 213

Page 172: Macro Expert Manual

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

Help for Macro Expert Move files

[email protected] 167 / 213

Page 173: Macro Expert Manual

Delete Files

Delete one or more existing files.

Parameters

Source

Specifies a full-qualified path and filename. The standard Microsoft MS-DOS wild cards arepermitted in the file-name position. Multiple file names may be specified by separating entrieswith a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will haveunpredictable 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 filename 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 notallowed.

Match case

Specifies whether the search finds the source files which names match the case of charactersin 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 bedeleted if it does not contains any files.

Put into Recycle Bin

With this option selected, if possible, the files will be put into the Recycle Bin until you decideto 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 \ inthe field Exclude mask. For example: \My Pictures;\My Music;.

Help for Macro Expert Delete files

[email protected] 168 / 213

Page 174: Macro Expert Manual

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. Relativepath is not permitted.

Retrieve path of new folder

Assign the path of the new folder to a variable for subsequent using. The variable can beempty.

Notes:

You may specify a multi-level folder to create, such as "c:\abc\abc\abc".

Help for Macro Expert Create a folder

[email protected] 169 / 213

Page 175: Macro Expert Manual

Delete a folder

Delete an existing folder.

Parameters

Folder

A full-qualified path contains the folder which need to removed. It will have unpredictableresults, 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 folderis empty.

Put into Recycle Bin

With this option selected, if possible, the files will be put into the Recycle Bin until you decideto permanently delete them.

Help for Macro Expert Delete a folder

[email protected] 170 / 213

Page 176: Macro Expert Manual

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 arepermitted in the file-name position. Multiple file names may be specified by separating entrieswith a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will haveunpredictable 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 filename 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 notallowed.

Match case

Specifies whether the search finds the source files which names match the case of charactersin 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 nameposition, 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 canbe:

Ignore, don't try to rename the fileAdd 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 indexnumber, it makes sure that the name of the file is uniquely under the specified folder, nomatter where it is.

Remark:

The destination name can contains one or more format control tags which are special codesused 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

Help for Macro Expert Rename files

[email protected] 171 / 213

Page 177: Macro Expert Manual

sensitive. Therefore, the "<m>" and "<M>" will do different the thing - "<m>" get the monthof the current date, and "<M>" get the minute of the current time.

NotesThe 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 begenerated, 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.

Tag Description

<s> Original file name.

<sl> Original file name in lowercase

<su> Original file name in uppercase

<lx> Get left x characters from the original name

<llx> Get left x characters from the original name in lowercase.

<lux> Get left x characters from the original name in uppercase

<rx> Get right x characters from the original name

<rlx> Get right x characters from the original name in lowercase

<rux> Get right x characters from the original name in uppercase

<ix,n> Get a substring from the orginal name n characters from theoriginal name, starting at position x (zero-based).

<ilx,n> In lowercase, get a substring from the orginal name ncharacters from the original name, starting at position x (zero-based).

<iux,n> In uppercase, Get a substring from the orginal name ncharacters from the original name, starting at position x (zero-based).

In above i tags, the ,n can be omitted to represent theremainder of the string.

<n> The index number of the source file in the searching.

<n?x> The index number of the source file in the searching, withprefix characters. The prefix characters will be added until theminimum width x is reached. For example, the index number is20 and the format control string of the destination name is"<nA5>"(i.e. the prefix character is 'A' and the width is "5".), anew name "AAA20" is generated.

<T> The current time

<D> The current date

<y> Year of the current date

<m> Month of the current date

<d> Day of the current date

<h> Hour of the current time

<M> Minute of the current time

<e> Second of the current time

Example

The original file name : "MacroExpert.txt"

Help for Macro Expert Rename files

[email protected] 172 / 213

Page 178: Macro Expert Manual

The current date and time : "08/05/2005 01:00"

Destination name controlstring Generated new name

abc.txt abc.txt

<s>.<s> MacroExpert.txt

<sl>.<sl> macroexpert.txt

<su>.<su> MACROEXPERT.TXT

abc-<su>.<su> abc-MACROEXPERT.TXT

<l5>.<l3> Macro.txt

pic<lu5>.<lu3> picMACRO.TXT

pic-<rl5>.jpg pic-xpert.jpg

pic-<n03>.jpg pic-001.jpg

pic-<ll5><n-3>.jpg pic-macro--1.jpg

pic-<D>.<s> pic-08-05-2005.txt

<l5>---<i5>.<s> Macro---Expert.txt

<l5>---<i5,2>.<s> Macro---Ex.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 \ inthe field Exclude mask. For example: \My Pictures;\My Music;.

Help for Macro Expert Rename files

[email protected] 173 / 213

Page 179: Macro Expert Manual

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 arepermitted in the file-name position. Multiple file names may be specified by separating entrieswith a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will haveunpredictable 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 filename 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 notallowed.

Match case

Specifies whether the search finds the source files which names match the case of charactersin 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.

Help for Macro Expert Set file attributes

[email protected] 174 / 213

Page 180: Macro Expert Manual

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

Help for Macro Expert Set file attributes

[email protected] 175 / 213

Page 181: Macro Expert Manual

Change file(s) date and time

Change the time of one or more existing files or folders, include created time, last modifiedtime.

Parameters

Source

Specifies a full-qualified path and filename. The standard Microsoft MS-DOS wild cards arepermitted in the file-name position. Multiple file names may be specified by separating entrieswith a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will haveunpredictable 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 filename 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 notallowed.

Match case

Specifies whether the search finds the source files which names match the case of charactersin 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

With this option selected, a new time can be set on the file or folder. If the option isunchecked, 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 willnot 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 containacceptable 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.

Help for Macro Expert Change file time

[email protected] 176 / 213

Page 182: Macro Expert Manual

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 \ inthe field Exclude mask. For example: \My Pictures;\My Music;.

Help for Macro Expert Change file time

[email protected] 177 / 213

Page 183: Macro Expert Manual

Synchronize Folders

Synchronizes files between two folders which may be separated in two drivers or even in twocomputers. You may use the instruction to synchronize documentation between a local harddriver and a removable driver, or between a local hard driver and a remote network driver. Youalso utilize the instruction to remove unwanted files from the destination folder according to aspecified folder.

Parameters

Source

Specifies a full-qualified path and filename. The standard Microsoft MS-DOS wild cards arepermitted in the file-name position. Multiple file names may be specified by separating entrieswith a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will haveunpredictable results, if you use the relative paths.

Exclude mask

Specifies one or more source file names which don't synchronize at this operation. Also, eachfile name must be terminated by a single semicolon, and standard Microsoft MS-DOS wildcards, such as "*", are permitted in the file-name position. The wild cards name "*.*" does notallowed.

Match case

Specifies whether the search finds the source files which names match the case of charactersin 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 andwild cards are not permitted in the name position. It will have the unpredictable result, if youuse 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

With this method of synchronization, the latest version files in the source folder will be copiedinto destination folder.

Birdirection

With this method of synchronization, the latest version files in the source folder will be copiedinto destination folder, and the latest version files in the destination folder will be copied intosource folder too.

Difference synchronization

The synchronization will remove unwanted files in the destination folder. All the files which do

Help for Macro Expert Synchronize Folders

[email protected] 178 / 213

Page 184: Macro Expert Manual

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

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 \ inthe field Exclude mask. For example: \My Pictures;\My Music;.

Help for Macro Expert Synchronize Folders

[email protected] 179 / 213

Page 185: Macro Expert Manual

Compress Files

Compresss the files into a zip file. You may utilize the instruction to backup yourdocumentation, music, picture and other archives.

Parameters

Source

Specifies a full-qualified path and filename. The standard Microsoft MS-DOS wild cards arepermitted in the file-name position. Multiple file names may be specified by separating entrieswith a semi-colon. For example: c:\documents\*.*, c:\documents\*.doc;*.jpg;*.inc. It will haveunpredictable 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 filename 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 notallowed.

Match case

Specifies whether the search finds the source files which names match the case of charactersin 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 filesAddes all files into the archive.Freshen existing filesUpdates files already in the zip file.Move filesAddes all files into the archive and remove the files from the disk.Update or add filesIf the file already in the zip file, it will be update, otherwise, it will be added into thezip file.

Compression

Determines the level of compression. Specifies how to compress the files, the faster optionsusually 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

Help for Macro Expert Compress files

[email protected] 180 / 213

Page 186: Macro Expert Manual

Specifies whether to convert the long file name into 8.3 DOS style. If the zip file will be usedin 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 \ inthe field Exclude mask. For example: \My Pictures;\My Music;.

Help for Macro Expert Compress files

[email protected] 181 / 213

Page 187: Macro Expert Manual

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 singlesemicolon, and standard Microsoft MS-DOS wild cards, such as "*", are permitted in the file-name position.

Exclude mask

Specifies one or more file names which don't extract at this operation. Also, each file namemust 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 charactersin 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, thefolder 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.

Help for Macro Expert Extract a zipped file

[email protected] 182 / 213

Page 188: Macro Expert Manual

Read text file

Read from a plain-text file.

Parameters

Source file name Specifies a full-qualified name of the source file.

Position for reading Specifies the position of reading. It can be one of the following:

Specify the line numberBeginning of the fileRead 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 thereading position exceeds the end of the file, the value is the number 1, otherwise, it is0.

Ignore EOF error Specifies whether to ignore the EOF error.

Note:

For more information about the variable, please click here

Help for Macro Expert Read text file

[email protected] 183 / 213

Page 189: Macro Expert Manual

Write text file

Write the content into a plain-text file.

Parameters

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 fileBeginning of the fileSpecify the line number

Write content Specifies the content for writing.

Text encoding format Specifies the text encoding, it can be one of ANSI, UNICODEand UTF8.

Failed if destination file exist Specifies whether to write into a new file.

Truncate destination file W ith the option checked, the player will truncate the contentof the file from the writing position, then writes the content.

Don not write new-line character W ith the option unchecked, the CRLF character willbe placed the end of the content automatically.

Note:

For more information about the variable, please click here

Help for Macro Expert Write text file

[email protected] 184 / 213

Page 190: Macro Expert Manual

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 with Specifies the substitution string. To remove the sub string from thevariable, 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 allmatched.

Use regular expression Specifies whether to use regular expression. W ith this optionunchecked, you may also use wildcards such as asterisks (*) and question marks (?) insearch string.

Backup original file Specifies whether to backup the ordinal file before saving thechanes.

Populate variable with number of substitutions made If the sub string (pattern) isnot found, return value is 0.

Populate variable with next start position Specifies a variable to hold the next startposition, 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 athttp://en.wikipedia.org/wiki/Regular_expression.

Help for Macro Expert Replace in File

[email protected] 185 / 213

Page 191: Macro Expert Manual

Open Document

(This action is available in Enterprise Edition only)

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 documenttype does not support the open password, the parameters will be ignored.

Password to modify Specifies the password to modify the document, if the documenttype 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 openingthe 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 willnot be closed after playback.

Automatically save changes of document before closing it Specifies whether to savethe changes before closing the document. The option is applied to the situation thatthere is no "Close Document" action after this action, otherwise, it depends on theoption in the action "Close Document".

Document name Specifies name for identifying a document from others, otherdocument related instructions will use the name to select an opened document ratherthan the path name of the document file.

Note:

To open a Microsoft Excel document, Microsoft Excel program must be present in thecomputer before playing a macro.

If opening the document failed, the global variable "error" will be set to "ERR".

Help for Macro Expert Open Document

[email protected] 186 / 213

Page 192: Macro Expert Manual

Close Document

(This action is available in Enterprise Edition only)

Closes an opened document, or terminates the connection of document which is opened in theparent task. If the document has been closed before executing the step, the step will beignored.

Parameters

Save changes of document before closing it. If the option is checked, Macro Playerwill attempt to save the changes before closing it. Otherwise, it will discard thechanges and directly before closing the document.

Note:

The document must be opened by the instruction "Open Document", or be connected by theinstruction "Connect a Opened Document" before this step.

Microsoft Excel program must be present in the computer before playing a macro whichcontains this instruction.

Help for Macro Expert Close Document

[email protected] 187 / 213

Page 193: Macro Expert Manual

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:

The document must be opened by the instruction "Open Document", or be connected by theinstruction "Connect a Opened Document" before this step.

Microsoft Excel program must be present in the computer before playing a macro whichcontains this instruction.

Help for Macro Expert Save Document

[email protected] 188 / 213

Page 194: Macro Expert Manual

Read EXCEL Document Cell

(This action is available in Enterprise Edition only)

Reads the value or formula of a cell from an opened Microsoft Excel Document, and stores theread 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 beread.

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 thevariable if the row number exceeds the max row in the used range, otherwise, thenumber 0 will be stored. You could check out the variable's value to determine if alldata have been read/written in the used range.

When failed to read from cell Specifies the secondary error level if gets an errorduring reading.

Note:

The document must be opened by the instruction "Open Document", or be connected by theinstruction "Connect a Opened Document" before this step.

Microsoft Excel program must be present in the computer before playing a macro whichcontains this instruction.

Help for Macro Expert Read Microsoft Excel Cell

[email protected] 189 / 213

Page 195: Macro Expert Manual

Write EXCEL Document Cell

(This action is available in Enterprise Edition only)

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 bewritten.

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 theformula.

When failed to write data into cell Specifies the secondary error level if gets an errorduring writing.

Note:

The document must be opened by the instruction "Open Document", or be connected by theinstruction "Connect a Opened Document" before this step.

Microsoft Excel program must be present in the computer before playing a macro whichcontains this instruction.

Help for Macro Expert Write Microsoft Excel Cell

[email protected] 190 / 213

Page 196: Macro Expert Manual

Find EXCEL Cell

(This action is available in Enterprise Edition only)

Searches the worksheet for a cell that matches a specified criteria.

Parameters

Document name Specifies the document for reading, the document should be openedby the instruction "Open Document" before this step is performed.

Worksheet name Specifies the name of the worksheet which contains the cell to beread.

Look in column Specifies which column will be searched, the column should be in rangefrom '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 partialcells.

Return row number into Specifies the variable to hold the row number if a match ispresent. If the search does not find any cell, the number -1 will be stored into thevariable.

Note:

The document must be opened by the instruction "Open Document", or be connected by theinstruction "Connect a Opened Document" before this step.

Microsoft Excel program must be present in the computer before playing a macro whichcontains this instruction.

Help for Macro Expert Find Microsoft Excel Cell

[email protected] 191 / 213

Page 197: Macro Expert Manual

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.

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 theinstruction "Connect a Opened Document" before this step.

Microsoft Excel program must be present in the computer before playing a macro whichcontains this instruction.

Help for Macro Expert Add Microsoft Excel Worksheet

[email protected] 192 / 213

Page 198: Macro Expert Manual

Remove Excel Worksheet

(This action is available in Enterprise Edition only)

Removes an existed worksheet from the Excel document.

Parameters

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 theinstruction "Connect a Opened Document" before this step.

Microsoft Excel program must be present in the computer before playing a macro whichcontains this instruction.

Help for Macro Expert Remove Microsoft Excel Worksheet

[email protected] 193 / 213

Page 199: Macro Expert Manual

Activate Excel Worksheet

(This action is available in Enterprise Edition only)

Activates an existed worksheet in the Excel document.

Parameters

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 theinstruction "Connect a Opened Document" before this step.

Microsoft Excel program must be present in the computer before playing a macro whichcontains this instruction.

Help for Macro Expert Activate Microsoft Excel Worksheet

[email protected] 194 / 213

Page 200: Macro Expert Manual

Wait for MacroSoft Excel Cell

(This action is available in Enterprise Edition only)

Waits for one or more cell until meet the specified criterial. The action is useful when you'd liketo 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 bythe 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 whichcontains this instruction.

Help for Macro Expert Wait for Microsoft Excel Cell

[email protected] 195 / 213

Page 201: Macro Expert Manual

Connect to Data Source

(This action is available in Enterprise Edition only)

Establishes a connection to the data source, or connects the connections is opened in theparent task. After this action successfully completes, the connection is live until close it, andyou 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 importantinformation to the datasource. The easiest way to generate a connection string is bypressing the right button.

Connection name in parent task For the option "Connect to data source in parenttask, specifies the connection name of the data source which is opened in the parenttask.

Location of cursor service Specifies the location of the cursor service. You can choosebetween 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 bereferred in subsequent steps for accessing the data source.

Help for Macro Expert Connect to Data Source

[email protected] 196 / 213

Page 202: Macro Expert Manual

Close Data Source Connection

(This action is available in Enterprise Edition only)

Closes a data source connection, also closes any active dataset associated with theconnection.

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 theconnection to it

Help for Macro Expert Close Data Source Connection

[email protected] 197 / 213

Page 203: Macro Expert Manual

Transaction 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.

Commit transaction Saves any changes and ends the current transaction.

Rollback transaction Cancels any changes made during the current transaction andends the transaction.

Notes:

Not all data providers support transactions .

Help for Macro Expert Transaction on Data Source

[email protected] 198 / 213

Page 204: Macro Expert Manual

Execute SQL Statement

(This action is available in Enterprise Edition only)

Executes the specified query, SQL statement, stored procedure, or provider-specific text on thedata source.

Parameters

Directly connect to data source Specifies a string used to establish a connection tothe data source. The connection string provides driver, server, username, password andother important information to the datasource. The easiest way to generate aconnection string is by pressing the right button.

Use existed data source connection Specifies the data source connection that shouldbe 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 nameof the variable, which receives the value of the number of records that the executionthe 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 bereferred in subsequent steps for accessing the data.

Notes:

A dataset contains multiple records and multiple fields, and it can only be created by thisinstruction. A dataset name can be used many times in a script, and it will be closedautomatically before creating again.

To access the data in the dataset, use the instructions "Get Field Value", "Set Field Value",and "Change Current Record Position".

Help for Macro Expert Execute SQL Statement

[email protected] 199 / 213

Page 205: Macro Expert Manual

Connect Dataset in Parent

(This action is available in Enterprise Edition only)

Establishes a connection to a dataset, which is opened or connected in the parent task. Itusually used to share the dataset between the scripts.

Parameters

Dataset name Specifies the name of the dataset, which whill be used in this scriptand its sub scripts.

Dataset name in parent task Specifies the name of the dataset which isopened/connected in the parent task.

Help for Macro Expert Connect Dataset In Parent

[email protected] 200 / 213

Page 206: Macro Expert Manual

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:

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

Help for Macro Expert Close Dataset

[email protected] 201 / 213

Page 207: Macro Expert Manual

Set Field Value

(This action is available in Enterprise Edition only)

Places the specified value into the field in the dataset.

Parameters

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 startsfrom 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 iththe 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 "Connectdataset in parent task".

Help for Macro Expert Set Field Value

[email protected] 202 / 213

Page 208: Macro Expert Manual

Get Field Value

(This action is available in Enterprise Edition only)

Retrieves the data from a opened dataset.

Parameters

Dataset name Specifies the name for the dataset. The dataset must be opened orconnected prior to this instruction.

Field name/index Specifies the field name or field index number (starts from thenumber 0).

Return read value into variable Specifies the name of the variable that should bepopulated with the read result.

Do not log execution message Specifies whether to log the execution message. W iththe 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 "Connectdataset in parent task".

Help for Macro Expert Get Field Value

[email protected] 203 / 213

Page 209: Macro Expert Manual

Change Current Record Position

(This action is available in Enterprise Edition only)

Moves the position of the current record in the dataset.

Parameters

Dataset name Specifies the name for the dataset. The dataset must be openedbefore.

Move position of current record to Specifies how to move the position of the currentrecord. It can be one of the following:

Moves to the first recordMoves to the previous recordMoves to the next recordMoves to the last recordMoves to backward or forward x records

Current record position moves to x steps Specifies the number of records that thecurrent record position moves.

Return EOF/BOF state into variable Specifies the name of the variable that will bepopulated with the EOF or BOF state.

Do not log execution message Specifies whether to log the execution message. W iththe 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 isEOF or BOF, 0 is not.

For more information about the dataset, please refer to "Execute SQL Statement" or "Connectdataset in parent task".

Help for Macro Expert Change Current Record Position

[email protected] 204 / 213

Page 210: Macro Expert Manual

Command line Usage

Macro Player is designed to allow the user playing a macro from the command lineenvironment, 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 commandis:

"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 bequoted 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.

Times 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 theampersand 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"

Help for Macro Expert Command Line Usage

[email protected] 205 / 213

Page 211: Macro Expert Manual

Variable and Expression

Variable

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, characterstrings, date time or other data type.

Variables play an important role in Macro Expert because they enable you to create flexiblemacros. Rather than entering data directly into a script, you can use variables to represent thedata. Then, when the macro is played, the variables are replaced with real data. This makes itpossible for the same macro to process different sets of data. For example, you might want touse the action "Mouse Move" for placing the mouse pointer at a position, and the positionshould be determined when the macro is played. You can use the variable to represent thecoordinates value of the position. Depending on the value of variable, the mouse pointer willbe placed at the different position.

Every variable has a name, called the variable name, and a data type. A variable's data typeindicates 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 anExternal DLL".

In Macro Expert, there are two type variables, the global variables and local variables. Theglobal variables are predefined by the software for holding those general content, such as thecurrent 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 informationabout working with the local variables, please click here.

String

Holds sequences character code which represents a single character. The string datatype 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 quotationmarks. You may use \' to represent the single quotation sign, and use the \" torepresent 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 invalue from -1.79769313486231570E+308 through -4.94065645841246544E-324 fornegative values and from 4.94065645841246544E-324 through1.79769313486231570E+308 for positive values. Double-precision numbers store anapproximation of a real number.

Help for Macro Expert Variables and Expressions

[email protected] 206 / 213

Page 212: Macro Expert Manual

The number data type supports + operator, - operator, * operator, / opeartor and \ modoperator. 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, forexample, 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 datafor the instruction "Call an External DLL".

For reading the content in a binary data, you could use the instruction "Advanced GetVariable Value".

Array

An array is a collection that holds a fixed number of variables. These variables have the samename. Each variable in an array is called an element, and each element is accessed by itsnumerical index. The numerical index is also called subscript, and it begins with the number0. 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 valueelements that hold values. Value elements include variables, constants, returns fromFunction and Operator procedures, and expressions.

Macro Expert supports +, -, *, /, \(mod) and () operator, and it will convert the rightvalue element to the appropriate data type before performing the operation, as thefollowing example demonstrates.

%="abc "+20.03%' The preceding expression evaluates to "abc 20.03".

%=20.03 + "abc"%

Help for Macro Expert Variables and Expressions

[email protected] 207 / 213

Page 213: Macro Expert Manual

' The preceding expression evaluates to 20.03.

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

Using Expression

To use an expression, simply quote the expression by percentage signs, and use theequal mark to lead, like this: %=1+2%, or %=5 * VARIABLENAME% (substitute VARIABLENAME for the variablename you used.)

The equal mark could be ignored if the expression does not include the operator, forexample, %VARIABLENAME%.

Special character

Percentage sign %Uses the \% to represent the percentage sign in an expression. For example,%="100\%"+"abc"%.

New line signUses the \n to represent the new line sign in an expression. For example,%="100\n"+"abc"%.

Tab characterUses the \t to represent the horization tab character in an expression. For example,%="100\tabc"%.

Note:

New line sign and Tab 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 SYSTEMTIME in W indows API.

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

Help for Macro Expert Variables and Expressions

[email protected] 208 / 213

Page 214: Macro Expert Manual

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 wantto 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 addsome triggers to turn automatically play on.2. And then you need to change the "Playback" of the macro to allow the macro rununder the situation. Just select the macro in the macro list and click "Property" toolbutton on the toolbar, and then switch to the "Background mode" tab on theproperties dialog.3. Select the "run as a specific user" or "run as background user" in the "If no useris logged or the workstation is locked".4. If you select the "run as a specific user", don't forget to type the "logon/lockinformation"

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 windowsagain.

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?

Help for Macro Expert Frequent Question and Answer

[email protected] 209 / 213

Page 215: Macro Expert Manual

Open Macro Manager, click the Change Settings and then select "General" tab,uncheck the item "Automatically run Macro Manager when I log on to thewindows".

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 "Playwith parameters".Please note: The macro can not be scheduled or triggered to play if a macro is not inthe 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 youhave 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 asystem event occurs, and a macro will play at its scheduled time. Macro Service isresponsible for watching conditions that would cause a triggered or scheduled macroto play. It also monitors the hotkey of macro. A triggered or scheduled macro will belaunched even if you quit Macro Manager. To stop this, you have to to disable alltriggers or stop the Macro Service.

Help for Macro Expert Frequent Question and Answer

[email protected] 210 / 213

Page 216: Macro Expert Manual

Help for Macro Expert Purchasing Macro Expert

[email protected] 211 / 213

Page 217: Macro Expert Manual

Contact Grass Software

Technical Support

If you need technical support, please feel free to contact us at [email protected] andinclude your name, address, email address. We will be happy to help you. When you post atechnical support issue, you should include: System configuration (CPU, RAM, OS, DISK SPACE,etc.) Detailed problem description (include exact error message text) How to reproduce theproblem.

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].

Help for Macro Expert Contact Grass Software

[email protected] 212 / 213

Page 218: Macro Expert Manual

License Agreement

END USER LICENSE AGREEMENT REGISTERED VERSION PLEASE READ THIS LICENSE

CAREFULLY BEFORE USING THIS SOFTWARE.

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 of21 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 specialamount of computers, for any legal purpose, at a time. The registered Macro Expert softwaremay not be rented or leased, but may be permanently transferred, if the person receiving itagrees to terms of this license. If the software is an update, the transfer must include theupdate and all previous versions.

- The Macro Expert unregistered shareware version may be freely distributed, provided thedistribution package is not modified. No person or company may charge a fee for thedistribution of Macro Expert without written permission from the copyright holder.

- Macro Expert IS DISTRIBUTED "AS IS". NO WARRANTY OF ANY KIND IS EXPRESSED ORIMPLIED. YOU USE AT YOUR OWN RISK. THE AUTHOR WILL NOT BE LIABLE FOR DATA LOSS,DAMAGES, LOSS OF PROFITS OR ANY OTHER KIND OF LOSS WHILE USING OR MISUSING THISSOFTWARE.

- 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 licensedprogram, except as provided for in this agreement. Any such unauthorized use shall result inimmediate and automatic termination of this license and may result in criminal and/or civilprosecution.

All rights not expressly granted here are reserved by Grass Software.

- Installing and using Macro Expert signifies acceptance of these terms and conditions of thelicense.

- If you do not agree with the terms of this license you must remove Macro Expert files fromyour storage devices and cease to use the product.

CONTACT INFORMATION===================

Tech Support: [email protected] & Sales: [email protected] Software: http://www.macro-expert.com

Help for Macro Expert License Agreement

[email protected] 213 / 213