Процедура ЗаполнитьЗначенияСвойств() позволяет копировать значения свойств объекта-источника в свойства объекта-приемника.
Одним из применений данной процедуры может являться заполнение реквизитов одного документа реквизитами другого. Если объекты имеют сходную структуру, то использование процедуры встроенного языка ЗаполнитьЗначенияСвойств() позволит скопировать значения одноименных реквизитов из одного объекта в другой.
Например: заполнение реквизитов документа «РасходнаяНакладная» значениями реквизитов документа «ПриходнаяНакладная»:
Для копирования данных из одной таблицы значения в другую в типовых конфигурациях 1с 8 существует процедура модуля ОбщегоНазначения.ЗагрузитьВТаблицуЗначений. Она добавляет в таблицу значений строки из другой таблицы значений, наименования колонок должны совпадать.
- ТаблицаИсточник — таблица значений, откуда берутся значения.
- ТаблицаПриемник — таблица значений, куда добавляются строки.
Также можно создать полную копию таблицы значений используя метод Скопировать
- (необязательный). Тип: Массив. Массив строк для копирования. Если не указан, копируются все строки таблицы значений.
- (необязательный). Тип: Строка. Список колонок для копирования в формате: “Колонка1, Колонка2…”.
Копирует свойства одного объекта в одноименные свойства другого
Синтаксис
Процедура ЗаполнитьЗначенияСвойств() имеет следующий синтаксис:
А также альтернативный англоязычный синтаксис:
Параметры
Описание параметров процедуры ЗаполнитьЗначенияСвойств() :
| Имя параметра | Тип | Описание |
|---|---|---|
| Приемник | Произвольный | Значение, чьи свойства будут заполнены значениями соответствующих свойств Источника .
Внимание! Значение данного параметра не может быть примитивного типа! |
| Источник | Произвольный | Значения свойств данного объекта будут установлены в соответствующие свойства Приемника .
Внимание! Значение данного параметра не может быть примитивного типа! |
| СписокСвойств (необязательный) | Строка | Ограничивает список имен свойств которые необходимо заполнить. Имена свойств указываются через запятую. Если параметр опущен, то копируются только те свойства, которые представлены одновременно и в Источнике , и в Приемнике . |
| ИсключаяСвойства (необязательный) | Строка | Список имен свойств Приемника, разделенный запятыми, которые необходимо исключить из заполнения. Если свойства, указанного в параметре не окажется в Приемнике , будет вызвано исключение. |
| Жирным шрифтом выделены обязательные параметры | ||
Описание
Процедура ЗаполнитьЗначенияСвойств() Копирует свойства одного объекта в одноименные свойства другого. Сопоставление свойств производится по именам. Если указан параметр СписокСвойств , то в заполнении участвуют только они, параметр ИсключаяСвойства игнорируется. В противном случае, если указан параметр ИсключаяСвойства , свойства перечисленные в нем, исключаются из обработки.
Доступность
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение(клиент), мобильное приложение(сервер).
Пример использования
Пример кода с использованием процедуры ЗаполнитьЗначенияСвойств() :
