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