Get Started with Omnistudio Integration Procedures

Learning Objectives

After completing this unit, you’ll be able to:

• Explain Integration Procedures in Omnistudio for Managed Packages.
  
• List Integration Procedure capabilities and uses.
  
• Explain the benefits of Integration Procedures.
  

This module covers Omnistudio for Managed Packages, which uses the managed package runtime and custom objects. For details about Omnistudio on standard runtime, see Omnistudio in Salesforce Help.

See Which Version of Omnistudio Do You Have? for help deciding if this badge is right for you.

Meet Omnistudio Integration Procedures

When you need to access and transform data from third-party sources and no user interaction is required, and when moving the workload from client to server is desirable—that's when you want to use an Omnistudio Integration Procedure in Omnistudio for Managed Packages. 

Omnistudio Integration Procedures are applications used to read and write data from Salesforce and from external systems. An Integration Procedure can be called from an Omnistudio component such as an Omniscript or Flexcard, an API, or even from an Apex method. 

Omnistudio Integration Procedures are declarative, server-side processes that execute multiple actions in a single server call. Let’s break this down to better understand what it means. 

• Declarative: Use drag-and-drop elements in the Integration Procedure Designer in Omnistudio for Managed Packages to build the process structure.
  
• Server-side processing: This enables faster performance, because the server is usually faster than the client at processing data.
  
• Multiple actions in a single server call: This prevents round trips to the server. Minimizing client/server calls is beneficial, as more round trips mean slower performance.
  

More simply, Integration Procedures are a way to get, save, and manipulate data behind the scenes. They’re especially useful when:

• You must access and transform data from third-party sources.
  
• No user interaction is required.
  
• Moving the workload from client to server is preferable.
  

In this module, you will learn some basics about Omnistudio Integration Procedures, one of the primary components in Omnistudio for Managed Packages’ Service Management layer. 

Integration Procedure Capabilities

Integration Procedures do what they do thanks to a host of awesome capabilities. Let’s take a look at a few.

Integration Procedures handle multiple data sources. They read data from Salesforce, external systems through representational state transfer (REST) and application programming interface (API) calls, and Apex classes.

Integration Procedures serve as data sources for multiple technologies. They’re called from and return data to Omnistudio Omniscripts and Flexcards. They also serve as data sources for APIs and Apex code.

Integration Procedures are portable. You can build an Integration Procedure once and use it everywhere. You can use the same Integration in a Flexcard as well as in an Omniscript. 

Integration Procedures only send and receive the data you need. An often overlooked performance factor is the amount of data sent between the browser and the server. The Integration Procedure’s Response Action trims the data returning to the browser from the server. This minimizes client/server data transfer, which is a key factor if you’re on a slow network or using a mobile connection. 

Here's an example. An Integration Procedure uses an HTTP Action to call data using an API key. The data comes in as a JSON and contains extraneous information (1). You can use the properties of the action element (2) to trim the JSON and send only the node that is needed to an Omnistudio Data Mapper Transform Action (3). You can not only trim the JSON further, but also re-map the data before sending it to the tool that called it.

Integration Procedures perform batch processing. They process large amounts of data without causing a Salesforce timeout. 

As you can see, Integration Procedures have some fantastic capabilities. Next, let's examine how they make working with data management easier.

Integration Procedure Advantages

We recommend using Integration Procedures as much as possible as a data source. Why? Because they have a streamlined structure that’s efficient and consistent. They’re adaptable to use with all your data sources and easy to navigate. 

But that’s not all. They give developers a lot more control over the data going back and forth and also:  

• Provide optimal flexibility.
  
• Make implementations easier.
  
• Greatly improve the performance of Flexcards and Omniscripts.
  

Another huge advantage of using Integration Procedures is that they future-proof your design. 

For example, when you design a Flexcard, you need data from the server. However, you might not yet be entirely sure what that data looks like or how to get it. Here’s how Integration Procedures provide a solution.

• You create your Integration Procedure with sample data, and call the Integration Procedure from the Flexcard. You move forward in your card design, even if the backend system isn't yet ready.
  
• When that backend system becomes ready, you simply make the changes to the Integration Procedure, and you’re up and running. You no longer have to touch your Flexcard.
  

This approach is a good way to separate your development work on the front end from your development work on the back end.

In addition to these benefits, replacing Apex classes with Integration Procedures has several perks. For example, Integration Procedures:

• Are much easier to maintain and update.
  
• Take up to 97% less development time.
  

Let’s take a closer look at that last point. Here’s a comparison of development times with Omnistudio implementations when using custom Apex classes versus using Integration Procedures.

Integration Procedures are pretty impressive, if we do say so ourselves!

In the next unit, you will learn all about the Integration Procedure Designer. 

Resources

• Salesforce Help: Integration Procedures (Omnistudio for Managed Packages)