Macro Expert » Macro Editor Quick Start Guide

Macro Editor Quick Start Guide

This is a user guide for helping the users who aren't familiar with Macro Expert to quickly master the basic of the usage, including how to run Macro Editor, how to insert actions, how to delete or edit actions and some basic skills for building a macro script as well.

What is Macro Editor?

Macro Editor is an editor for modifying macro scripts. Macro scripts built by the user or macro scripts got by other ways can be modified in Macro Editor, and also you can build a new macro script in Macro Editor. Actually, advanced features of Macro Expert can be preformed by choosing the right actions in Macro Editor.

When do you need to use Macro Editor?

There are two conditions to use Macro Editor:

  1. Modify the existing macro scripts.

    Modify the existing macro scripts, like inserting the new actions, changing some actions, etc.

  2. Build a new macro script.

    If the application is more complex, the macro script built by the recording way basically is unable to meet the needs for it has not any intelligent judgment, so you need to build a macro script by using Macro Editor. For example, inputting data onto the webpage and then submitting it. This operation bases on the website, and the website speed is affected by the network speed, sometimes the network speed is slow and sometimes it is fast, so that the way of simulating the moue and keyboard actions can't meet this need. Besides most of features offered by Macro Expert can't be performed by the recording way, you need to use the advanced actions built-in Macro Editor.

Where is Macro Editor and how to run it?

First, open Macro Manager by double clicking the icon on the desktop and click the macro script that you need to modify, and then click the "Edit macro" button on the toolbar. If you want to build a new macro script by Macro Editor and then click the "New macro" button on the toolbar, and then choose the option "Create a blank macro for editing manually". Macro Editor is like the image below:

Introduction to Macro Editor

Macro Editor Window is mainly composed of three parts:

  1. Actions pane

    At the left of the window, there is the actions pane that lists all the actions and these actions are classified based on the type of the action.

  2. Steps pane

    At the top right of the window, there is the steps pane that shows all the steps of this macro script.

  3. Information pane

    At the lower right corner, there is the information pane that is composed of three parts: play log tab, user variable tab and global variable tab. The playing log can be showed on the play bog tab when debugging the macro; the variables defined by the user can be listed on the user variable tab; and all the global variables can be listed on the global variable tab as well.

Which operations are commonly used on editing a macro script?

There are some basic operations when editing a macro script:

  1. Insert actions

    There are several ways to insert the action:

    1. In Macro Editor, just click the menu "Insert", and choose the action that you want to insert.

    2. Double click the action that you want to insert on the left window of the actions pane.

    3. Drag/pull the action listed on the left window of the actions pane into the right window of the steps pane. In this way you can drag the action to the location where you want.

  2. Delete actions

    First choosing the action that you want to delete and then right click the action to delete it. If there are several actions needed to delete, press the "SHIFT" key and then use the keyboard upward or downward key expansion constituency or click directly on the other line to expansion constituency. After choosing the actions, just press the "Delete" key or choose the "Delete" button on the toolbar to delete the actions.

  3. Edit actions

    First choosing the action that you want to edit and then right click the action to edit it. If there are several actions needed to edit, press the "SHIFT" key and then use the keyboard upward or downward key expansion constituency or click directly on the other line to expansion constituency.

    After chose the action, just press the "RETURN" key, or choose the "Edit" button on the toolbar to edit the action.

    If you want to edit several steps at the same time, a "General" dialog box will pop up.

  4. Disable/Enable

    Disable is different from Delete which will remove the actions from the macro script while Disable just doesn't allow Macro Player to play the actions, but not to remove them. When the action don't need to be performed temporarily, Disable can be used.

    If you want to disable several actions, choose them and then just press the "SPACE" key. If the action has been disabled, you can click it to enable.

  5. Add/Remove/Edit variables

    In the information pane, there is tab "User variables". In the tab, you can click the "Add" button to add a variable, and click the "Remove" button to remove a variable, and click the "Edit" button to edit a variable as well. Learn more about the variables, please refer to "Variables and Expressions"

How to use Macro Editor to debug a macro script?

After building a macro script, you need to debug it. The so-called debugging is to check the macro script whether it is right as expected.

As for the simple macro script, you just need to play it directly, and then you can know whether it is right. But for the complex macro script, it's no use to play it directly, and sometimes you have no idea about which step is wrong or why it is wrong so that you need to debug the macro script.

In order to facilitate debugging the macro script, there are more functions built-in Macro Editor in co-ordination with Macro Player to perform a certain task.

  1. Begin debugging

    Open the debugging macro script in Macro Editor. You are sure that the debugging macro script is the current for Macro Editor supports opening multiple macro scripts at the same time. Like the image below.

    Click the "Play" menu and choose "Debugging Play" to begin debugging. In Macro Editor, there is white text on a black background which indicates upcoming steps. Like the image below:

  2. Set breakpoint

    A very important function in Macro Expert is the breakpoint. When debugging playing, the player will shop after meeting a breakpoint, and now you can know the playing through the information pane, and the user variables and the global variables as well.

    To set a breakpoint is to press the key F9 when moving to the corresponding line or click the "Play" menu and then just choose "Break". When setting a breakpoint for a line, in the front of this line there is a little red dot.

  3. Step by step

    This playing model can be used in conjunction with breakpoint. In debugging playing the player will be stopped when meeting a breakpoint and then you can know the variables and the other conditions. Now you may need the player to play the next action, then you need to use step by step.

    When the player meets a breakpoint and wants to play the next action, you just need to click "step" in the "Play" menu. Also you can click the step button on the play progress window or press the "F10" key.

Conclusion:

Macro Editor is a frequently used tool for building a macro script. You can use it to edit a macro script or build a new macro script. Macro Editor is usually start in Macro Manager, and some common operations are these actions, like inserting actions, deleting actions that you don't need, editing actions and enabling actions that you now don't need temporarily as well.

In addition, Macro Editor is also a full-functioned macro debugger. Whether or not a macro script can meet the requirements, you can play the script in Macro Editor and then step by step to follow playing.