Использование методов быстрого редактирования объектов может привести к нестабильности системы. По возможности старайтесь использовать обычные методы редактирования!
Используйте методы быстрого редактирования объектов очень аккуратно и внимательно, так как происходит редактирование напрямую в базе данных и далеко не все проверки, которые реализованы при помощи стандартной бизнес-логики, реализованы в этих методах.
При вызове данных методов действия по событию не выполняются. Запись в историю событий отмечается кодом категории: fastEdit.
Допустимо использовать данный метод для сохранения большого числа ссылок на бизнес-объектов, а для примитивных типов (текст, числа, даты) рекомендуется использовать стандартный utils.edit
При выполнении методов быстрого редактирования проверка на совпадение старого значения с новым не выполняется и любое изменение объекта влечет запись в истории изменений объекта, даже если ничего не менялось. Это может привести к большому числу строк в истории изменений объекта.
-
api.systemUtils.fillAttrsDirect(object, attrValue)
api.systemUtils.fillAttrsDirect(object, attrCode, attrValue)
Редактирование атрибутов объекта напрямую в базе. Можно редактировать сразу несколько атрибутов.
Метод предназначен для редактирования атрибутов типа: строка, текст, текст в формате RTF, набор ссылок на БО, ссылка на БО, обратная ссылка, целое число, логический, элемент справочника, набор элементов справочника, гиперссылка, временной интервал, вещественное число, набор типов класса, дата, дата/время.
Коды атрибутов, запрещенных для редактирования: removed, removalDate, creationDate, lastModifiedDate, serviceTime, clientOU, clientEmployee, clientTeam, agreement, service, timeZone, stateStartTime, registrationDate, requestDate, wfProfile, massProblem, massProblemSlaves, masterMassProblem, hasMasterProblem, resolutionTime, deadLineTime, folders, UUID, clientLinkName, parent.
Параметры метода:
- object — UUID объекта или сам объект, который необходимо редактировать;
- attrCode — код атрибута, значение которого меняется;
- attrValue — ассоциативный список кодов изменяемых атрибутов и устанавливаемых значений.
Результат выполнения метода: изменяются указанные значения атрибутов. Для атрибутов типа "Набор ссылок на БО", "Набор элементов справочника" и "Обратная ссылка" метод добавляет указанные значения к уже существующим значениям этого атрибута.
Метод возвращает null если:
- атрибут не принадлежит к типам, разрешенным для редактирования данным методом;
- значение атрибута является вычислимым, составным, вычисляется по таблице соответствий, определяется по правилу формирования номера или по правилу именования;
- выполняется попытка изменить значение атрибута, запрещенного для редактирования.
-
api.systemUtils.removeBOLinksDirect(object, attrCode, objsToRemove)
Удаление указанных объектов из значений атрибута типа "Набор ссылок на БО", "Набор элементов справочника" и "Обратная ссылка"
-
Параметры метода:
- object — объект или его UUID;
- attrCode — код атрибута, значение которого меняется;
- objsToRemove — объекты или их UUID, которые необходимо удалить из значения атрибута.
-
