ConfigurationKeySet Class

The ConfigurationKeySet class enables working with a tree of configuration keys.

Syntax

class ConfigurationKeySet extends Object

Run On

Called

Methods

	Method	Description
	cancelTimeOut	Cancels a previous method call to the setTimeOut method. (Inherited from Object.)
	cnt	Retrieves the number of configuration keys that are defined in the Microsoft Dynamics AX Application Object Tree (AOT).
	cnt2Id	Retrieves the ID of the nth configuration key.
	enabled	Determines whether to enable or disable the object.
	equal	Determines whether the specified object is equal to the current one. (Inherited from Object.)
	getTimeOutTimerHandle	Returns the timer handle for the object. (Inherited from Object.)
	handle	Retrieves the handle of the class of the object. (Inherited from Object.)
	loadSystemSetup
	new	Initializes a new instance of the Object class. (Overrides the new Method.)
	notify	Releases the hold on an object that has called the wait method on this object. (Inherited from Object.)
	notifyAll	Releases a lock on the object that was issued by the wait method on this object. (Inherited from Object.)
	objectOnServer	Determines whether the object is on a server. (Inherited from Object.)
	owner	Returns the instance that owns the object. (Inherited from Object.)
	pack	Serializes the current instance of the ConfigurationKeySet class.
	setTimeOut	Sets up the scheduled execution of a specified method. (Inherited from Object.)
	toString	Returns a string that represents the current object. (Inherited from Object.)
	touchedByUser
	usageCount	Returns the current number of references, that is, the value of the reference counter, that the object has. (Inherited from Object.)
	wait	Pauses a process. (Inherited from Object.)
	xml	Returns an XML string that represents the current object. (Inherited from Object.)

Top

Remarks

When a new ConfigurationKeySet is created, a tree of configuration keys is created, where all keys are set by default to "enabled".

The cnt method is used to loop through all configuration keys and count them.

The cntID method is used to retrieve the IDs of the configuration keys. In situations in which a configuration key has been deleted and the key IDs are ID1, ID2, ID5, and so on, this method will distinguish the number of configuration keys compared to their IDs.

When a new ConfigurationKeySet is created, all configuration keys are enabled. The system will then call the loadSystemSetup method, which scans the SysConfig table where the configuration types are stored. It loops through the configuration key setup and identifies what is enabled.

Next, the enabled method is called. Every time a configuration key is disabled, all sub-configuration keys are also automatically disabled. In a situation in which a top node is enabled and one of the sub-nodes is disabled, the kernel will remember which configuration key sub-nodes were previously disabled whenever a top node is disabled.

Inheritance Hierarchy

Object Class
  ConfigurationKeySet Class