Skip to main content

Object Change Event in RCOM Gateway

The Object Change event type in RCOM 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 Groups, and triggers an associated workflow automatically via an Event Processor.

When Is the Event Triggered?

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

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

These triggers are configured per Object Group. 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 group name
  • The type of operation
  • The associated object data

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

How to Set Up an Event Processor for Object Changes

  1. Go to Settings > Client Settings > Event Processor.

  2. Click ➕ Create New.

  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 Config, set:

    • OBJECT_GROUP_NAME: Select the group you want to monitor (e.g., DEVICE)
    • Enable one or more of:
      • ADDED_OBJECT → captures Create
      • UPDATED_OBJECT → captures Update
      • DELETED_OBJECT → captures Delete
info

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

  1. Choose the Workflow Name and Version to execute.
  2. Click Save.
info

Once configured, the Event Processor will monitor the selected group 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 group 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.