SetRdsElements

Syntax

SetRdsElementsResult SetRdsElements(RdsId tRds, SetRdsElementsArg tArg)

Parameters

tRds. Opened dictionary instance moniker.

tArg. Parameters for changing information about dictionary elements.

Description

The SetRdsElements operation changes information about MDM dictionary elements.

Comments

This operation enables the user to make the following changes:

Change attribute values for the elements.
Create new elements and delete existing ones.
Move elements thus changing the dictionary hierarchy.
Delete outdated values from version dictionaries.

To execute the operation, in the tRds parameter specify the opened MDM dictionary instance moniker, and in the tArg parameter specify operation execution parameters. The moniker can be obtained on executing the OpenRds operation, the dictionary should be opened for view (tArg.openForEdit = false).

The following fields must be defined depending on the operations to be executed:

To execute operations with a single element: specify element key in the tArg.key field, and the operation to be executed in the tArg.op field. Updated information on the element can be specified in the tArg.data field. To move an element, define the tArg.moveTo field.
To execute operations with a group of elements: depending on the operation to be executed, define parameters in the following fields: tArg.update, tArg.insert, tArg.del, or tArg.delChildren.
To clear a dictionary, define conditions in the tArg.cleanup field.

The operation results in the result of executing some operation with the selected element or elements collection. All the changes are automatically saved.

Example

Various methods of using the operation are given in the following examples:

Example name

Inserting a new element

Moving elements

Updating information about element

Deleting elements