How macros works

Macro functions are placeholders in your phrase which are replaced with dynamic contents into the static phrase at the time of phrase insertion.

Example:

PhraseExpress processes macro functions sequentially (with the only exception of form input macros) and replaces the macro placeholder with the current date:

If you trigger the same phrase on another day, the corresponding updated date and time would be inserted.

Adding a macro

To add a macro function to a phrase:

1. Click in the phrase text where you wish to add a macro.
2. Select the desired macro function from the macro menu:
   
   
3. Configure the parameters in the macro configuration dialog.

To edit an existing macro function, double-click the macro placeholder token.

Macro configuration dialog

A typical macro configuration dialog consists of:

• The macro name input field.
• Macro parameters which are explained in this manual.
• Optional additional processing steps.

Macro name

The macro name is the text label of the macro token/placeholder:

The label only serves "cosmetic" purposes for your identification of your macros. Choose a short name that describes the purpose of the macro.

Example: For a macro, that outputs a the current date plus 14 days for a payment reminder phrase, you may want to name it "Date+14d" or "PaymentReminderDate".

If no name is entered, PhraseExpress shows the underlying macro code in the phrase instead of the beautiful macro token:

The code view is interesting for expert users only, who like taking a peek under the hood.

You can toggle between code vs token view at any time by defining a macro name or removing it.

Macro parameters

Most macro functions have parameters and options which are explained for each macro in this documentation.

The Clou: Macro parameters can contain additional macro functions - Macros can be nested!

Example applications:

• Embed a phrase into another phrase based on a specific date or time, or the value of a Excel spreadsheet cell content, a user input, a calculation, etc.
• Calculate a math expression consisting of a temporary variable, CSV file value and/or a Windows environment variable content, etc.
• Pre-fill an user input prompt with the current date.

To achieve the latter example:

1. Create a phrase and click where you wish to add the macro function.
2. Select macro "User input » Manual input".
3. Click the icon in the input field "Default".
4. Select macro function "Time/Date" and configure that macro in its own macro configuration dialog.
5. By clicking OK , the date/time macro token is inserted in the input field "Default".
6. By clicking OK in the "Manual Input" macro dialog, the entire nested macro function is inserted into the phrase.

Additional processing

The macro output can be processed by a queue of addditional macro functions:

To add processing steps, click the button "Additional processing" at the bottom of a macro input dialog and add processing steps as required. All processing steps will be daisy chained and executed from top to bottom.

Example: To create a prompt for a text input which is then changed to upper case and finally placed into the clipboard:

1. Add a "Manual Input" macro.
2. In that macro input dialog, click the button "Additional processing" at the bottom.
3. In the subsequent window, click "Add processing" and select "Set to upper case" from the list of actions.
4. Add a second processing step and select "Set clipboard content".
5. Confirm all dialogs with OK

For experienced PhraseExpress users: Each processing step in the processing queue encloses the current macro onion-like.