SetRdsElementsResult SetRdsElements(RdsId tRds, SetRdsElementsArg tArg)
tRds. Моникер открытого экземпляра справочника.
tArg. Параметры изменения информации об элементах справочника.
Операция SetRdsElements изменяет информацию об элементах справочника НСИ.
Данная операция позволяет произвести следующие изменения:
Изменить значения атрибутов у элементов;
Создать новые и удалить существующие элементы;
Переместить элементы, изменив тем самым иерархию справочника;
Производить очистку версионных справочников от устаревших значений.
Для выполнения операции необходимо в параметре tRds указать моникер открытого экземпляра справочника НСИ, а в параметре tArg указать параметры выполнения операции. Моникер может быть получен при выполнении операции OpenRds. В зависимости от выполняемых действий необходимо задать следующие поля:
Для выполнения действий с одним элементом: укажите ключ элемента в поле tArg.key, а выполняемое действие в поле tArg.op. Обновленная информация об элементе может быть указана в поле tArg.data. Для перемещения элемента определите поле tArg.moveTo;
Для выполнения действий с группой элементов: в зависимости от выполняемого действия определите параметры в полях tArg.update, tArg.insert, tArg.del или tArg.delChildren;
Для очистки справочника определите условия в поле tArg.cleanup.
Результатом работы операции будет результат выполнения действий над заданным элементом или коллекцией элементов. Все изменения сохраняются автоматически.
Различные варианты использования операции приведены в следующих примерах:
| Наименование примера |
| Вставка нового элемента |
| Перемещение элементов |
| Обновление информации об элементе |
| Удаление элементов |
См. также: