Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEV and version next


The following method can be used to replace a macro definition with steps that you have created in a recipe.


Tip: When replacing a macro, you can create new inputs for new steps and reassign inputs from the previous version to the steps that haven't changed.

Please complete the following steps.


  1. To replace all steps in the macro with new ones:
    1. Create the steps in a recipe that you wish to use. 
    2. When you are ready to use them to replace a macro, select Create or replace macro from the context menu.
  2. To modify the steps currently in the macro: 
    1. Open a recipe containing an instance of the macro. 
    2. Select the step that applies the macro. From the context menu, select Convert macro to steps.
    3. All of the macro steps are now listed as individual steps in your recipe. 
    4. Add, remove, or modify steps to define your new macro.


      Tip: You may want to remove the comment steps that mark the beginning and ending of the converted macro.

    5. When you are ready to use them to replace the macro, select all of the steps. From the context menu, select Create or replace macro.
  3. In the Create macro dialog, select Replace an existing macro from the drop-down.
  4. From the Replace macro dialog, select the existing macro to replace.
  5. If you want to save the copy of the existing macro, select the corresponding checkbox.


    NOTE: Replacing an existing macro replaces all the macro steps with the steps of the new macro. All instances of the previous definition of the macro now reference the new macro definition. In some cases, you may need to reassign input values on old instances to align with the inputs in the updated macro definition.

  6. Define macro inputs: 

    1. If the old version of the macro contained inputs, you should review those inputs and reassign them to values in the new macro definition.


      NOTE: If you do not reassign the macro inputs from the old definition to the new one, then the values used for those inputs in macro instances created under the old definition are lost. After the replacement version is saved, you must review each instance of the macro to verify that it is working properly.

    2. You can also create new macro inputs that apply to the added or modified steps.

    3.   See "Update macro inputs" below.

  7. After you have reviewed the input, to replace the macro with the existing inputs, click Replace

    1. If you do not specify a relationship between the existing inputs and the replacement macro's inputs, a warning message is displayed.


      NOTE: If you discard and save the changes, then any references to those inputs in the instances  of the macro in the previous definition are broken.

    2. Click Discard to save the macro.