Invoke Omnistudio Data Mappers

Easy to build and reusable, you can call Data Mappers from other Omnistudio tools, such as Integration Procedures, Omniscripts, and Flexcards. But Apex classes, batch jobs, or REST APIs, can also call Data Mappers. With a Data Mapper, centrally manage data transactions to use in multiple applications.

For example, an organization receives regularly updated files with new user information in an XML format. They configure a Data Mapper Load to parse, transform, and load this XML data into multiple related Salesforce objects (such as Account, User, and Contact).

As another example, a Salesforce Flow creates or updates an Account, several related Contacts, and a custom Policy record at one time from user input. Rather than creating multiple steps in Flow, create a single Data Mapper Load to handle the entire multi-object upsert. A Flow can call a simple Integration Procedure that invokes the Data Mapper Load.

• Omnistudio Data Mapper REST API
  You can invoke any type of Data Mapper using the Data Mapper REST API. To update Salesforce objects using a Data Mapper Load, issue a POST request that includes a JSON payload that is formatted to comply with the input that the Data Mapper load expects. To retrieve data from Salesforce, issue a GET call to a Data Mapper Extract, specifying the Id or parameters identifying the data to be retrieved. The data is returned in the response in JSON format.
• Omnistudio Data Mapper Calls From Apex
  Starting with Summer’ 25, to call a Data Mapper from Apex, call the ConnectApi.OmniDesignerConnect.executeDataMapper(bundleName, apexInput) Connect API specifying the name of the Data Mapper and the input data that it requires. This API replaces the vlocity_ins.DRGlobal.processObjectsJSON() method. This Connect API removes the dependency on the managed package and provides up to 60% better performance for Data Mapper calls from an Apex class compared to the previous method.
• DRGlobal Class and Methods
  Use the ConnectApi.OmniDesignerConnect.executeDataMapper(bundleName, apexInput) Connect API to call Data Mappers from Apex through the DRGlobal Apex class. Starting with Summer ’25, replace the existing methods in the DRGlobal Apex classes with the Connect API.