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 Type | Description |
|---|---|
Create | Triggered when a new object is created in the object group. |
Update | Triggered when any attribute of an existing object is modified. |
Delete | Triggered when an object is deleted from the object group. |
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
-
Go to Settings > Client Settings > Event Processor.
-
Click ➕ Create New.
-
In the Event Source, select any value (mandatory, but irrelevant for this event type).
-
Under Trigger Type, select
Object Change. -
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 CreateUPDATED_OBJECT→ captures UpdateDELETED_OBJECT→ captures Delete
Enable only the operations relevant to your use case. To handle multiple operations in one workflow, enable multiple options.
- Choose the Workflow Name and Version to execute.
- Click Save.
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_OBJECTfor object groupDEVICE - Workflow:
RegisterNewDevice - Result: Every time a new device is created, its details are passed to the workflow which updates inventory and alerts the team.