Finale Knowledge Base

How to Create and Use Custom Actions

Custom Actions are a set of predefined updates and actions that can be triggered to run for one or many orders through the main list view. They automate common updates and actions. Each custom action is built on two core components:

  1. Fields to Update: A list of fields that will be updated by the custom action and what values will be used for the update.

  2. Actions: One or more operations that are applied to the orders selected.

Custom Actions can be configured for sales orders, purchase orders, and transfer orders.


Custom Action Configuration

Creating Custom Actions

Tip: The quickest way to edit custom actions is to use the dropdown action menu in the order's view screen and select customize action menu items.

The Custom action details screen is where users create new rules and edit existing ones. Each order type has its own menu of custom actions that only apply to that order type.

In Application Settings > Screens > View sales (or purchase or transfer), use the Add another custom action link to create a new custom action. You will automatically be redirected to the configuration screen to give it a name and set up the custom action.

Custom action items list with three custom actions and the Add another custom action item link highlighted

The order of the list determines the order they will be shown in your Actions menu drop down on the Order view screen.


Fields to Update

A list of the fields that will be updated by the automation for orders that meet the filter criteria. Fields can either be set using a defined value or the value can be mapped from a separate field altogether.

Fields to update section with two numbered fields set by a fixed value and by copying from Batch ID

  1. Add field to update: Used to add additional fields to update.

  2. Field to Update: Choose the field that will be updated.

  3. Value to Set (first field)

    1. Value: Uses a user input value

    2. Copy from: Copies the value from a different field to set the value for the field to update.

  4. Value to Set (second field): The value to use for "Value" or the field to copy from if "Copy from"

  5. Remove:f Used to remove the field to update from the list


Actions

A list of the actions that will be done to the orders that meet the filter criteria.

  1. Select an action: Choose the action that will be applied to the order. Selecting an option will display the option or function that will be set for that action. For example, if "Set delivery confirmation" is chosen, the action will be to choose what Delivery confirmation will be set for the order. Each action will have its corresponding value shown below once it is selected.

  2. Add: Once the configuration for the action is set, clicking Add adds it to the list of actions. The configuration of the action will be saved and displayed in the section immediately above the Add section. All available actions can be added if needed.

  3. Actions to perform: This is where the actions that have been added will be listed. Users can edit the configuration here.

  4. Remove Action: Used to remove actions.

Note: Actions are added in a predefined order which cannot be customized. This is the order in which the actions are performed.

Actions section of a custom action with the action dropdowns, the Add button and the remove icon numbered


Navigation and Saving

  • To save changes, click the Save button located at the top-right corner of the page.

  • To return to the Custom Actions list, use the navigation link at the top-left of the screen.


Running Custom Actions

  1. Navigate to the Sales, Purchase, or Transfer order list view (sales list view showing below).

  2. Select the order (or orders) that you wish to apply the custom actions to.

  3. Use the Actions dropdown menu to choose the custom action to run.

  4. Choose the custom action.

    Sales list with orders selected and the Actions menu open, showing three custom actions highlighted

    A confirmation dialog will be displayed that summarizes the orders that you will be updating with a button to continue.

  5. Click Next to run the custom actions.

    Confirmation dialog to run the Update Tags and Customer custom action for two selected sales, with a Next button


Example

Scenario

A seller has created a batch of manual sales that have all been shipped already, but not yet invoiced. The seller needs to invoice the sales, update a tag, and mark the order as complete, all in one step.


Configuration

  • Field to Update

    • Add Tag: Apply the selected tag(s) to the orders

  • Actions

    • Invoice order: (Optional: set Reference Number for the invoice)

    • Complete order

Back to top