Руководство разработчика

Метод ТАБ_ФОРМА.ПОДСТАВИТЬ_ДАННЫЕ

Метод ПОДСТАВИТЬ_ДАННЫЕ позволяет осуществить подстановку данных в ячейки табличной формы унифицированным способом.

ФУНКЦИЯ ЛОГИКА: ПОДСТАВИТЬ_ДАННЫЕ(ПОДСТАНОВКА_ФОРМЫ: подстановка)

Параметры

подстановка
Набор простых и табличных подстановок.

Возвращаемое значение

ДА – в случае успешного выполнения, НЕТ – в противном случае.

Тип ПОДСТАНОВКА_ФОРМЫ используется также функцией ЭКСПОРТ_ФОРМЫ для передачи данных внешним приложениям. Использование одинаковой структуры данных позволяет унифицированным способом передать данные для табличной формы и внешних приложений (Word и Excel).

Для простых подстановок имя строкового ключа подстановки ассоциируется с именем раздела и строковым идентификатором ячейки в виде:

<имя раздела>:<идентификатор ячейки>

Если имя раздела опущено, то подразумевается первый раздел табличной формы. Используется простой строковый идентификатор ячейки, а не одно- или двумерный.

Для табличных подстановок имя строкового ключа подстановки ассоциируется с именем раздела и строковым идентификатором стартовой строки подстановки в виде:

<имя раздела>:<идентификатор строки>

Если имя раздела опущено, то подразумевается первый раздел табличной формы. Используется простой строковый идентификатор строки, а не одномерный. Стартовая строка копируется необходимое количество раз, в зависимости от количества строк подстановки. В полученные строки подставляются данные соответствующих строк табличной подстановки. Ключевой строкой в пределах строки табличной подстановки служит простой (а не одномерный) строковый идентификатор столбца (раздел здесь, разумеется, не указывается).

В значениях подстановок могут указываться инструкции удаления строк, столбцов, ячеек или таблицы целиком.

Пример заполнения табличной формы при помощи подстановок.


См. также: