Метод АНАЛИТИКА.ЗАП_СВОЙСТВО
Метод ЗАП_СВОЙСТВО позволяет установить значение свойства объекта в плане аналитики. Путь относительно типообразующего объекта берется из поля _код.
ФУНКЦИЯ ЛОГИКА: ЗАП_СВОЙСТВО(СТРОКА: имя;
СТРОКА: тип;
*<СТРОКА, ЧИСЛО, ЦЕЛОЕ, ЛОГИКА, ДАТА, ВРЕМЯ,
ССЫЛКА, КОНТ_СВОЙСТВО>: значение;
ЛОГИКА: во_времени = ДА)
Параметры
- имя
- Имя свойства. Свойство с указанным именем должно существовать.
- тип
- Тип свойства. Для задания используются константы ТСВ_...
- значение
- Значение свойства. Тип значения должен соответствовать типу свойства объекта аналитики. Функция поддерживает запись свойств любых типов, кроме ТСВ_АЛГОРИТМ и ТСВ_МЕТОД. При этом:
- типу ТСВ_ТЕКСТ соответствует значение типа СТРОКА;
- для типов ТСВ_КАРТИНКА и ТСВ_БИНАРНЫЙ в качестве значения задается путь к файлу;
- типу ТСВ_КОНТЕЙНЕР соответствует значение типа КОНТ_СВОЙСТВО.
- во_времени
- Признак сохранения предыдущего значения во времени: ДА – предыдущее значение сохраняется во времени (для свойства должно быть разрешено сохранение истории, иначе этот параметр игнорируется), НЕТ – не сохраняется, значение заменяется новым в текущей временной точке (даже при разрешенной записи истории).
Возвращаемое значение
ДА – в случае успешной записи, НЕТ – в случае ошибки. В частности, ошибка может возникнуть, если свойства с указанным именем не существует.
Обрабатывать результат можно с помощью функции ПОСЛ_ОШИБКА.
Замечание: необходимо учитывать, что установка значения свойства в плане аналитики (в том числе с помощью метода ЗАП_СВОЙСТВО) не приводит к соответствующему изменению значения поля объектного типа, который представляет объект аналитики во внутреннем языке. Чтобы получить текущее состояние объекта, необходимо считать его с помощью метода СЧИТАТЬ или СЧИТАТЬ_М.