Skip to main content
Version: 3.9

Object Change Event in R-COM Gateway

The Object Change event type in R-COM Gateway allows you to build reactive workflows that respond to changes in object data. This mechanism listens for object-level CRUD operations (Create, Update, Delete) performed within defined Object Schemas and triggers an associated workflow automatically through an Event Rule.

When Is the Event Triggered?​

The event is emitted when an object in a designated Object Schema undergoes any of the following operations:

Action TypeDescription
CreateTriggered when a new object is created in the Object Schema.
UpdateTriggered when any attribute of an existing object is modified.
DeleteTriggered when an object is deleted from the Object Schema.
info

These triggers are configured per Object Schema. Enable them while defining the group’s structure.

Event Type: Object Change​

All Create, Update, and Delete operations generate a unified event of type Object Change.

The event includes:

  • The Object Schema name
  • The type of operation
  • The associated object data

You can configure an Event Rule to listen for Object Change events, filter by operation types, and route them to a relevant workflow.

How to Set Up an Event Rule for Object Changes​

  1. Go to Automation > Event Rules.
  2. Select Create Event Rule.
  3. In the Event Source, select any value (mandatory, but irrelevant for this event type).
  4. Under Trigger Type, select Object Change.
  5. Under Trigger Configuration: ObjectChange, set the values that determine which changes trigger the rule:
ParameterTypeDescription
OBJECT_GROUP_NAME *StringSelect the Object Schema to monitor, for example DEVICE.
GROUPStringAn additional Group parameter available in the form. Its intended behavior requires product confirmation.
ADDED_OBJECTBoolTriggers for object creation.
UPDATED_OBJECTBoolTriggers for object updates.
DELETED_OBJECTBoolTriggers for object deletion.
info

Enable only the operations relevant to your use case. To handle multiple operations in one workflow, enable multiple options.

  1. Select Validate. When the Event trigger section shows Valid, choose the Target workflow and Workflow Version.
  2. Click Save.
info

Once configured, the Event Rule monitors the selected Object Schema and actions. When a match is detected, the event payload is passed to the workflow.

πŸ”„ Use Case Example​

Scenario: Automatically handle device registration.

  • Trigger: ADDED_OBJECT for Object Schema DEVICE
  • Workflow: RegisterNewDevice
  • Result: Every time a new device is created, its details are passed to the workflow which updates inventory and alerts the team.