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 field specify moniker of opened selection schema instance, and in the tArg field specify operation execution parameters. The moniker can be obtained on executing the OpenRds operation, the dictionary should open 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, determine parameters in the following fields: tArg.update, tArg.insert, tArg.del, or tArg.delChildren.
To clear a dictionary, determine 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