Test and Respond to the New Order Save Behavior
The Enable New Order Save Behavior setting helps Salesforce correctly evaluate custom application logic on records associated with the Order object.
If you create any type of package that includes the Order object, the installed package sometimes doesn’t work. If a subscriber org relies on a different order save behavior than their installed packages, the installed packages sometimes don’t work. To ensure the expected behavior, test Enable New Order Save Behavior with your installed packages.
After Enable New Order Save Behavior is selected, Salesforce evaluates and runs these customizations whenever an update to an order item record changes the parent order record.
- Order and order item validation rules
- Order and order item Apex triggers and classes
- Order and order item flows and processes
You can install packages that support old Order Save Behavior on subscriber orgs where New Order Save Behavior is enabled. However, you must verify that your package works with the new order save behavior.
After you verify that your package works with the new order save behavior and that all your packages associated with your Dev Hub org work with the new order save behavior, you can choose to enable the update in your Dev Hub org. We recommend that you support both the new and old order save behavior during your testing.
Test Unmanaged and First-Generation Managed Packages
- From Setup, in the Quick Find box, enter Release Updates, and select Release Updates. Locate the Enable New Order Save Behavior tile, and select Enable Test Run.
- Test the impact of the new behavior when an order or order item is edited. Review any custom application logic such as validation rules, Apex triggers and classes, workflow rules, flows, and processes.
- To show that your package is compatible with both new and old order save conditions, from Setup, in the Quick Find box, enter Package. Select the package that you tested and select Upload.
- Locate the Package Requirements section and disable New Order Save
Behavior.
When this setting is disabled and the release update is enabled, subscriber orgs using either the new or old order save behavior can install your package.
Test Unlocked and Second-Generation Managed Packages
- After creating a scratch org, enable the Release Update in it. From Setup, in the Quick Find box, enter Release Updates, and then select Release Updates. Locate the Enable New Order Save Behavior tile, and select Enable Test Run.
- Test the impact of the new behavior when an order or order item is edited. Review any custom application logic such as validation rules, Apex triggers and classes, workflow rules, flows, and processes.
When you’re ready to create a package version, specify the order save behavior in the definition file.
To Specify | Set Features in Scratch Org Definition File To |
---|---|
Old Order Save Behavior |
|
New Order Save Behavior |
|
New and Old Order Save Behavior |
|