Order Management Rules (OMR) Available Functions (Expressions) [Information]

Modified on Mon, 4 May at 3:09 PM

When working with Order Management Rules (OMR), especially with Custom Variables and Expressions that access specific data points within techSHIP, you may need auxiliary functions (or expressions) to process data before assigning them to variables.

This article serves as a technical reference dictionary for all the mathematical, string manipulation, and external data functions available in the OMR engine.


	To learn about the data sources available for your expressions, refer to Using Custom Variables and Expressions in OMR [Information]. To learn about the BillingAccountClient data source object, refer to Using Billing Account Level Variables in OMR [Information].

TABLE OF CONTENTS

General Syntax Rules
Weather and Temperature Functions
String Manipulation Functions
String Concatenation

General Syntax Rules

All functions use the syntax @(function-name). For example: @(truncate(ShipToName, 3))

Functions can be safely nested to perform multiple operations at once. For example: @(trim(replace([Order.ShipToPhone], '+1','')))


	Function names are strictly case-sensitive. Ensure you use the exact capitalization provided in the tables below when invoking functions to prevent rule failures.

Weather and Temperature Functions

Functions used to capture weather forecasts (such as minimum and maximum temperatures for origin and destination) are part of an advanced external integration.

To view the complete list of available weather expressions, their exact parameters, and a step-by-step tutorial on how to implement them in your rules, refer to the dedicated guide: Setting up Order Management Rules: Temperature-Controlled Shipping [Guide].

String Manipulation Functions

The following table lists the functions used to manipulate, clean, or extract text values:

FUNCTION SYNTAX	DESCRIPTION & PARAMETERS	EXAMPLE INVOCATION	EXECUTION RESULT
`replace(string, old, new)`	Replaces a specific substring within a larger string with a new value. Parameters: • `string`: The original text. • `old`: The substring to be replaced. • `new`: The replacement string.	`@(replace('Lorem ipsum', 'ipsum', 'dolor'))`	`Lorem dolor`
`trim(string)`	Removes all leading and trailing white spaces from a given string. Parameters: • `string`: The text containing extra spaces.	`@(trim(' text '))`	`text`
`truncate(string, position)`	Truncates a string to a specific number of characters, starting from the first character. Parameters: • `string`: The text to truncate. • `position`: The character count limit.	`@(truncate('Lorem ipsum', 3))`	`Lor`

String Concatenation

A special case within OMR expressions is concatenation, which allows you to merge multiple strings or variables together. Instead of a named function, concatenation uses the standard + operator.

Syntax: stringA + stringB

Example Invocation: @(@([CustomFields.CivName]) + @([CustomFields.OrigFromComp]))


	If you need to escape a specific character within any function or concatenation, simply enclose it in single quotes as a standard string. For example: if the `ShipToName` is John, using `@('@' + ShipToName)` will successfully return @John.