Create a Macro

You can create reusable macros from sequences of steps in your recipe. These macros can be applied in other locations of the recipe or in other recipes. 

• Macros are user-defined sequences of recipe steps that can be referenced independently and parameterized as needed. 
• For more information, see Overview of Macros.

Steps:

1. In the Recipe panel, select the step or steps that you want to include in your macro. 

   NOTE: Steps do not have to be consecutive. In the macro, steps are listed in the order in which they appear in the recipe.

2. From the context menu next to one of the selected recipe steps, select Create macro....
3. Enter a Name and optional Description value.
   1. The Name of the macro appears in the Designer Cloud application. Names must be unique.
   2. Click Next.

4. Specify any parameters:
   
   

   Figure: Specify macro parameters

   NOTE: After you create a macro, you cannot modify its parameters. You can specify non-default parameters in instances that you apply to your recipes.

   1. Left column: select steps in the macro.
   2. Middle column: for the selected step, review the values that were specified for the step in the original recipe. 
   3. Right column: as needed, you can parameterize the currently selected value from the middle column. For a selected value, you can choose to create a new parameter or use an existing parameter.
5. When you create a new parameter: 
   1. Its data type is determined by the value it is replacing in the original transformation. 
   2. You specify a name, description, and default value for it.
      1. Parameters that have an empty default value cannot be parameterized at runtime.
   3. To remove all uses of the parameter from the macro, click Remove all.
   4. To save your parameter, click Save.
6. When you choose to use a parameter:
   1. Select the parameter to use. 
   2. Specify its value as needed.
7. To create the macro and its parameters, click Create.
8. An Apply transformation step with the macro's name associated with it is added to your recipe at the selected location.

You can use macros that you have created in other recipe locations. See Apply a Macro.

You can manage macros through the Library page. See Macros Page.