Knowledge Base - API
Breadcrumbs

ConfigStateGraphParameters

ConfigStateGraphParameters contains the contextual information that governs the details returned in the state graph.

Constructors

ConfigStateGraphParameters()

ConfigStateGraphParameters(StateGraphSpec spec)

Properties

Data Type

Property

Description

string

Id

Returns or sets the optional designation for the top-level configuration to retrieve. If omitted, the root configuration will be the origin for the graph.

StateGraphSpec

Spec

 

Returns or sets the specification for what information should be returned in the state graph object.

Valid values include:

  • None

  • IncludeSysProps

  • IncludeInboundProps

  • IncludeRules

  • IncludeCategories

  • IncludeCategories_PropDefns

  • IncludeCategories_Options

  • IncludeCategories_Selections

  • IncludeChildConfigs

  • IncludeConfig

  • IncludeFullConfig

  • Default

  • All

string

SpecText

Returns or sets the specification for what information should be returned in the state graph via a concatenated string. This should only be used on platforms that do not support Flags Enum web service properties, such as a Java client.

StateGraphSpec

UsedSpec

Valid values include:

  • None

  • IncludeSysProps

  • IncludeInboundProps

  • IncludeRules

  • IncludeCategories

  • IncludeCategories_PropDefns

  • IncludeCategories_Options

  • IncludeCategories_Selections

  • IncludeChildConfigs

  • IncludeConfig

  • IncludeFullConfig

  • Default

  • All

StateGraphPagingInfo

DefaultPagingInfo

Sets or returns the default paging information to be used when returning the state graph object.

bool

UseExistingSession

If true, returns a state graph based on the current configuration session.

StateGraphType

GraphType

 

Sets or returns the type of state graph to return. Each of the types is structurally similar, though the minimal version only has the 'core' values populated and lacks much of the superfluous data.

Valid values include:

  • Minimal

  • Standard

Inheritance

ParametersBase

The ParametersBase class is the base class for the parameters types that are passed in to various methods on the service. All parameters-derived types have the parameters listed below.

Properties

Data Type

Property

Description

bool

OmitConfigurationXmlFromResult

Returns or sets whether or not the configuration xml should be omitted from the result object.

In general, the various methods that interact with the service will cause the configuration XML to be returned to the caller each time. It can be bandwidth and processing intensive to recreate the XML for each call. By setting this property to True, those steps will be skipped resulting in less data being transmitted and less server-side processing.

OperationsBehaviors

OperationBehaviors

This property is used to provide additional contextual behaviors to the service call. Provide an instance of the OperationBehaviors class with properties set to identify whether the configuration should be saved (via the Stateless services) or whether a StateGraph should be returned with the result of the web service call.

DiagnosticOutput

DiagnosticOutput

Specifies the type of diagnostic information that should be returned as a result of the service call.

Available values include:

  • None

  • RulesExecuted

  • RulesMessages

  • RulesChanges

This provides access to the rules that were executed along with their associated messages and changes. If set to a value other than None, the DiagnosticData property of the various Result objects will be populated.

bool

ValidateRequiredProperties

Returns or sets a value indicating whether the configuration should be validated for required Property values. The default value is true.