Execute a Boomi Process From a Custom Page

Using a public plugin, a WebApp Developer can execute Processes created in Boomi. This allows integration with a wide variety of external systems, as defined by Connectors.

Boomi Processes can be used, for example, to validate, import, and export data or to execute automation tasks, but are not limited to these actions.

Before performing these steps:

  • The Boomi Process can exist in Boomi. If data is returned after the Process executes, the Boomi Process must be included in the BOA Boomi Process template. If data is not returned, use any non-BOA Boomi Process template.
  • The IG Universal Connect data source, which includes the Boomi Atom ID, must be registered in the Data Source Registry in Common.
  • The WebApp Developer must understand how to create a view in SQL, how to design pages in the platform, and, depending on the Process, how to write Validation and Business rules.

To execute a Boomi Process from a custom page:

  1. Create a page view (Horizontal or Vertical) with an event. The view must have these columns with these exact names:

    • BoomiDataSourceId — The GUID that is the unique identifier that represents an IG Universal Connect (Boomi) Data Source. This value is populated from the DataSourceId field from ttDataSourceRegistry table and exists after the IG Universal Connect data source is registered in Common.

    • BoomiProcessId — The GUID that is the unique identifier that represents the Boomi Process to execute. This GUID can be found in the Boomi AtomSphere. Select the Process in the IG Universal Connect Template, and click Revision History. The GUID displays in the Component ID field.

The following columns are optional in the view.

 

  1. Register the
    DSP.DataSourceOperations.BoomiProcessExecutionPlugin public plugin as an event to the custom page.

The next steps to take depend on what action the Process performs:

  • If the Process sends data to an external system, this task is complete.
  • If the Process validates data, create Validation rules based on the data returned after successful execution.
  • If the Process imports data, create Business rules to update page data based on the data returned after successful execution.

NOTE: Whether status messages display and Business rules continue to run when a Process fails to execute successfully depends on whether the plugin is registered to a foreground or background event. If the plugin is registered to a foreground event, the status message displays to the user. However, no exceptions will be thrown and business rules will continue to run even if a Process fails to execute. If the plugin is registered to a background event, status messages do not display but an exception will be thrown when the Process fails to execute or the process results in an exception. In this case, business rules stop running. Configure whether an event runs in the foreground or background using the Event Process Type ID list box on the Page Events page.

To troubleshoot or monitor process execution, view the logs stored in the DSPCommon ttDebugLog table.