Configurator Updated Node Input

Input representation of the nodes to be updated in a product configuration.

JSON Example

This example updates a field on an already-added sales transaction item. The path uses the persistent Salesforce record ID, not a ref_* reference. Only include the changed fields in updatedAttributes.

1{
2  "updatedNodes": [
3    {
4      "path": ["801xx0000000001AAA", "802xx0000000001AAA"],
5      "updatedAttributes": {
6        "businessObjectType": "OrderItem",
7        "Quantity": 5
8      }
9    }
10  ]
11}

This example updates an attribute value on an already-added sales transaction item attribute. The path uses the persistent attribute record ID. Only include the changed fields in updatedAttributes. When a constraint model is active, include AttributeName and set it to the attribute’s developer name.

1{
2  "updatedNodes": [
3    {
4      "path": ["801xx0000000001AAA", "802xx0000000001AAA", "0AZxx0000000001AAA"],
5      "updatedAttributes": {
6        "businessObjectType": "OrderItemAttribute",
7        "AttributeName": "Length",
8        "AttributeValue": "10",
9        "AttributePicklistValue": null
10      }
11    }
12  ]
13}

Properties

Name	Type	Description	Required or Optional	Available Version
`path`	String[]	Path to the node that’s being updated.	Required	60.0
`updatedAttributes`	Map<String, Object>	Details of the object that’s being updated. This property supports fields of objects from the Sales Transaction context definition, including custom objects and fields in your extended context definition. When you update an `OrderItemAttribute` or `QuoteLineItemAttribute` node and a constraint model is active, include `AttributeName` and set it to the product attribute’s developer name. For matching behavior and default fallback, see Configurator API: Include the Attribute Developer Name When Creating or Updating Attributes.	Required	60.0