SetRdsElements

Синтаксис

SetRdsElementsResult SetRdsElements(RdsId tRds, SetRdsElementsArg tArg)

Параметры

tRds. Моникёр открытого экземпляра справочника.

tArg. Параметры изменения информации об элементах справочника.

Описание

Операция SetRdsElements изменяет информацию об элементах справочника НСИ.

Комментарии

Данная операция позволяет произвести следующие изменения:

• Изменить значения атрибутов у элементов;

• Создать новые и удалить существующие элементы;

• Переместить элементы, изменив тем самым иерархию справочника;

• Производить очистку версионных справочников от устаревших значений.

Для выполнения операции необходимо в параметре tRds указать моникёр открытого экземпляра справочника НСИ, а в параметре tArg указать параметры выполнения операции. Моникёр может быть получен при выполнении операции OpenRds, справочник должен открываться на чтение (tArg.openForEdit = false).

В зависимости от выполняемых действий необходимо задать следующие поля:

• Для выполнения действий с одним элементом: укажите ключ элемента в поле tArg.key, а выполняемое действие в поле tArg.op. Обновленная информация об элементе может быть указана в поле tArg.data. Для перемещения элемента определите поле tArg.moveTo;

• Для выполнения действий с группой элементов: в зависимости от выполняемого действия определите параметры в полях tArg.update, tArg.insert, tArg.del или tArg.delChildren;

• Для очистки справочника определите условия в поле tArg.cleanup.

Результатом работы операции будет результат выполнения действий над заданным элементом или коллекцией элементов. Все изменения сохраняются автоматически.

Пример

Различные варианты использования операции приведены в следующих примерах:

См. также:

Работа со справочниками НСИ