Module 10: Creating and Using Macros

Question 1

What macros useful for?

Answer 1

Useful when you frequently run searches or reports with similar search syntax

Question 2

When is the time range selected when using a macro?

Answer 2

At search time

Question 3

What are Macros?

Answer 3

Macros can be a full search string or a portion of a search that can be reused in multiple places

Question 4

Macros allow you to define one or more arguments within the search segment and also:

Answer 4

• pass parameter values to macro at execution time

- macro uses values to resolve search string

Question 5

How would you create a basic Macro?

Answer 5

• settings
• advanced search
• search macros

Question 6

After opening search macros what do you need to do to finish?

Answer 6

1. Click New Search Macro
2. Select the destination app
3. Enter a name
4. Type the search string
5. Save

Question 7

What should you do before saving your macro?

Answer 7

Test your searhc string before saving your macro. You can check the contents fo your macro with keyboard shortcuts (command-shift-E on Mac OS or control-shift-E on Linux or Windows) from the search bar in the search page

Question 8

How do you use a basic Macro?

Answer 8

• Type the macro name into the search bar
• Surround the macro name with the backtick (or grave accent) character (macroname)
• Pipe to more commands, or precede with search string

Question 9

What must you do when you add arguments to the macro?

Answer 9

Include the number of arguments in parentheses after the macro name
- montly_sale(3)

Question 10

What is the format you must use in the search definition field of a macro?

Answer 10

$arg$ example:

• currency=$currency$
• symbol=$symbol$
• rate=$rate$

Question 11

In the arguments field what should be entered?

Answer 11

The argument(s)

Question 12

What should be provided at search time when using a macro?

Answer 12

Provide one or more variables of the macro at search time

Question 13

What is the order that the arguments should be in?

Answer 13

Pass the arguments in the same order as you defined them

Question 14

Why should you not create macros with leading pipes?

Answer 14

Someone may put a pipe in front of the macro when using it in the actual search string

Question 15

Can you validate argument values in your macro?

Answer 15

Yes you can.

Question 16

How do you validate your argument values in your macro?

Answer 16

• Validate Expression: you can enter an expression for each argument (the argument must be enclosed in dollar signs)
• Validation Error Message: message that appears when you run the macro