How To Use SetValues In Integration Procedure

Integration Procedures (IPs) in Salesforce Industries are used to process data efficiently without writing code. One of the most commonly used elements inside an Integration Procedure is SetValues. It allows you to manipulate, merge, calculate, and transform data before sending it to the output or another system.

In this article, we will learn how to use SetValues in an Integration Procedure, how to merge element values, perform calculations, concatenate fields, and finally display the result using Response Action.

What Is SetValues in Integration Procedure?

SetValues is an element in Integration Procedure that allows you to:

• Assign static values
  
  
• Merge values from different elements
  
  
• Perform calculations using formulas
  
  
• Concatenate multiple fields
  
  
• Retrieve values from arrays or lists
  
  

It helps prepare and structure data in the required format before sending it to OmniScript, FlexCard, or an external system.

Use Case of SetValues

SetValues is commonly used when:

• You need to combine multiple input fields
  
  
• You want to format output data
  
  
• Calculations are required without Apex
  
  
• Data needs to be reused in another SetValues
  
  
• Final output must be shown in Preview or Response
  
  

Step 1: Create an Integration Procedure

The first step is to create an Integration Procedure.

Steps:

1. Go to Setup.
   
   
2. Search for Integration Procedure.
   
   
3. Click New.
   
   
4. Enter required details such as:
   
   
   • Name
     
     
   • Type
     
     
   • Subtype
     
     
   • Language
     
     
5. Save the Integration Procedure.
   
   

Once created, open it in Designer mode.

Step 2: Add SetValues to the Structure Panel

Now, add the SetValues element to the Integration Procedure.

Steps:

1. Open the Structure Panel.
   
   
2. Drag and drop SetValues into the Integration Procedure flow.
   
   
3. Rename it meaningfully (for example: SetValues_1).
   
   

This SetValues element will be used to define and manipulate data values.

Step 3: Configure Element Value Mapping

Inside SetValues, you define how values are assigned or merged.

Element Value Map Configuration:

1. Click on the SetValues element.
   
   
2. Go to the Element Value Map section.
   
   
3. Click Add New Value.
   
   
4. Define:
   
   
   • Element Name (output variable)
     
     
   • Value (static value, merge field, or formula)
     
     

This mapping helps transfer data from input JSON or other elements into new variables.

Step 4: Perform Operations Using SetValues

SetValues supports multiple operations that can be performed easily.

Common Operations in SetValues

Merge Fields

You can merge values from input or previous elements using merge syntax.
Example:

%Input:FirstName%

 

Calculations Using Formulas

You can perform mathematical operations like addition or multiplication.
Example:

%Input:Price% * %Input:Quantity%

 

Concatenate Two Merge Fields

You can combine multiple fields into one value.
Example:

%Input:FirstName% %Input:LastName%

 

Retrieving an Array Value

You can access values from an array using index-based notation.
Example:

%Input:Items[0].Name%

These features allow you to handle complex logic without writing Apex code.