ConfigurationRulesModifyInput.rules Property

Parent Object: ConfigurationRulesModifyInput

PreviewThis functionality is provided as a preview of intended future API capabilities. You are encouraged to use it and report any problems or suggestions using the Fusion API and Scripts forum.

Because this is a preview of future functionality, there is the possibility that it will change, which will possibly break any existing programs that use this functionality. Because of that, you should never deliver any programs that use any preview capabilities. For a distributed program, you should wait until it has moved from preview to released state.


Defined in namespace "adsk::fusion" and the header file is <Fusion/ConfigurationRules/ConfigurationRulesModifyInput.h>

Description

Gets and sets the rules to add or update on submit. Each rule's id field disambiguates: empty id ⇒ create a new rule on submit; non-empty id ⇒ update the existing rule with that id.

After modifyRules returns, inspect the result's issues array to detect blocks that degraded to placeholders. The batch does NOT roll back on per-block validation failures; the rest of the rule (and the rest of the batch) applies even if individual get/set blocks are replaced.

Syntax

"configurationRulesModifyInput_var" is a variable referencing a ConfigurationRulesModifyInput object.
# Get the value of the property.
propertyValue = configurationRulesModifyInput_var.rules

# Set the value of the property.
configurationRulesModifyInput_var.rules = propertyValue
"configurationRulesModifyInput_var" Is a variable referencing a ConfigurationRulesModifyInput Object.
#include <Fusion/ConfigurationRules/ConfigurationRulesModifyInput.h>

// Get the value of the property.
std::vector<Ptr<ConfigurationRule>> propertyValue = configurationRulesModifyInput_var->rules();

// Set the value of the property, where value_var is a ConfigurationRule.
bool returnValue = configurationRulesModifyInput_var->rules(value_var);
"configurationRulesModifyInput_var" Is a variable referencing a ConfigurationRulesModifyInput Object.
// Get the value of the property.
propertyValue = configurationRulesModifyInput_var.rules;

// Set the value of the property.
configurationRulesModifyInput_var.rules = propertyValue;

Property Value

This is a read/write property whose value is an array of type ConfigurationRule.

Samples

Name Description
Configuration Rules API Sample

Demonstrates reading and modifying configuration rules using the typed ConfigurationRules API.

Before running: Run in the DESIGN workspace from Scripts and Add-Ins (Python, C++, or TypeScript), unless the script states otherwise.

Version

Introduced in version October 2026