ChangeStateGQL (Superseded)
Changed on:
9 Oct 2025
Overview
Changes the state of any type of incoming entity to the status provided in the input parameter using the generic update status mutation in GraphQL. It changes the state of the `event.entityType` to `status` using GraphQL.
Superseded
This approach is still supported but no longer recommended for new implementations. It has been replaced by a more scalable alternative that aligns with Fluent’s product direction and will benefit from future enhancements.
Fluent recommends using the `SetState` Rule instead.
| Plugin Name | Inventory Reference Module |
|---|---|
| Namespace | [[account.id]].globalinventory |
The Inventory Reference Module is the foundation for inventory related implementations. It provides reference Workflows for inventory ingestion and processing. Extensible by design, use this Module as a base to build a solution to the needs of your customers.
The Inventory Module includes the following areas:
- Product Catalogue workflow
- Inventory Catalogue workflow
- Control Group workflow
- Virtual Catalogue workflow
UI Description
Changes the state of any type of incoming entity to the status provided in the input parameter using the generic update status mutation in GraphQL. It changes the state of the {event.entityType} to {status} using GraphQL.
Accepts
- ALL
Actions
- This Rule produces a MutateAction on any type of incoming entity to update the status
Rule parameters
Parameter | Description |
| The status to be applied to the entity in the incoming event |
Event attributes
This Rule does not directly identify any Event Attributes.
Exceptions
This rule may result in the following exceptions:
- IllegalArgumentException: When any required entity details are missing from the incoming event, for example:
- the
`entityId`is empty if it's a legacy-orchestrated entity - the
`entityRef`is empty if it's a non-legacyOrchestrated entity - the
`retailerId`is empty if it's a`RETURN_ORDER`/`RETURN_FULFILMENT` - the
`rootEntityRef`is empty if it's a`RETURN_FULFILMENT`
- the
- ActionException (with code 422): When an unsupported entity type is provided for update status mutation
- RubixException: When the update mutation operation fails
Configuration example
1{
2 "name": "[[account.id]].globalinventory.ChangeStateGQL",
3 "props": {
4 "status": "ACTIVE"
5 }
6}Detailed Technical Description
Based on the type of the incoming entity, this rule either calls GQL or REST API to update the status of the entity to the new `status` given in the input parameters.
