ForwardIfInventoryPositionStatusEquals
Rule
Changed on:
12 Aug 2025
Overview
This article covers the following topics:- Supported Entities:
`VIRTUAL_POSITION` - This rule produces a
`SendEventAction` - Rule Parameters
- Event Attributes
- Exceptions
- Configuration Example
- Detailed Technical Description
| Plugin Name | Inventory Reference Module |
|---|---|
| Namespace | [[account.id]].globalinventory |
- Product Catalogue workflow
- Inventory Catalogue workflow
- Control Group workflow
- Virtual Catalogue workflow
UI Description
Forwards the event {eventName} to the virtual position if the status of the corresponding inventory position matches any of {statuses}
Accepts
- VIRTUAL_POSITION
Actions
- This rule produces a
`SendEventAction`that forwards the incoming event as an inline event with the given name`{eventName}`if the status of the corresponding inventory position of the given virtual position is in the status list of the rule property. Otherwise, it does not have any output/output action.
Rule parameters
| Parameter | Description |
| eventName | The name of the event to be triggered |
| statuses | A list of inventory position statuses |
Event attributes
| Parameter | Description | Data Type | Required? |
| inventoryPositionRef | Inventory position ref | String | Optional |
| virtualCatalogueInventoryCatalogueRef | The ref of the inventory catalogue this virtual position is associated with | String | Required |
| virtualPositionProductRef | The product ref of the virtual position | String | Required |
| virtualPositionGroupRef | The group reference value of the virtual position | String | Required |
Exceptions
- This rule throws a PropertyNotFoundException when any rule parameter
`statues`or`eventName`are missing. - This rule throws an EventAttributeNotFoundException when missing any of the above event attributes.
Configuration example
1{
2 "name": "<AccountId>.globalinventory.ForwardIfInventoryPositionStatusEquals",
3 "props": {
4 "statuses": [
5 "ACTIVE"
6 ],
7 "eventName": "UpdateBaseVirtualPosition"
8 }
9}Detailed Technical Description
- The rule retrieves the corresponding inventory position based on the inventory catalogue ref and inventory position ref. If inventoryPositionRef is not provided, it’s calculated as
`{productRef}:{virtualPositionGroupRef}:DEFAULT` - Verify if its status is in the list of statuses given by the rule property.
- If yes, it forwards the inline event with the name
`{eventName}`. Otherwise, do nothing.
