Using custom function in a Dataraptor formula

In Vlocity Health and Insurance Spring '21 and later releases, we can use the FUNCTION function.

Suppose the business scenario requires some complex functionalities which cannot be handled through the functions provided by vlocity https://help.salesforce.com/s/articleView?id=sf.os_function_reference.htm.

We can call an apex class and build our custom logic in the apex class and use that in the dataraptor formula using the FUNCTION function.

1. Refer to the FUNCTION() function given at https://help.salesforce.com/s/articleView?id=sf.os_function_reference.htm.

We can call an apex class and its respective method and pass input values.

           FUNCTION('class', 'method', input)

a. Here let us create a logic to sum the Values of a Key named “KeyNode” added under an array named “inputSumNode”.

{
  "inputSumNode": [
      {
      "KeyNode": 1
      },
      {
      "KeyNode": 2
      }]
}

b. Under the DR Formula section, add the FUNCTION() formula and map class as “CustomFunctionImplementation”, method as “sum” and input as “inputSumNode”.

c. Now we are passing two objects under an array that have “KeyNode” values as 1 and 2 respectively. Now the expected output is 3, by adding 1 and 2.

2. Create a global apex class “CustomFunctionImplementation” which implements Callable.

a. Keep the “call” method the same as shown below. It will call the “invokeMethod” method.

b. Keeping the parameters for the “invokeMethod” method as shown below, we can check with the methodName passed from the FUNCTION() function, call the respective method, and execute our custom logic. For example, here we are calling a method called “sum” which will add the values under a Node named “KeyNode”.

c. Now under the sum method, we can have our custom logic for adding the values of “KeyNode” as shown below and return the result.

d. Now if we execute from DR, we can see the “SumOutput“ value as 3.

References:

1. https://help.salesforce.com/s/articleView?id=sf.os_function_reference_56716.htm&type=5

2. https://help.salesforce.com/s/articleView?id=sf.os_workflow_for_creating_custom_functions.htm&type=5