Функция ДОБ_ТАБЛ_ПОДСТ
Функция ДОБ_ТАБЛ_ПОДСТ добавляет подстановку для ячейки таблицы с заданным столбцом и строкой.
ФУНКЦИЯ ДОБ_ТАБЛ_ПОДСТ(ТИП_СТРОКА: ключ_таблицы, ключ_столбца; ТИП_ЧИСЛО: номер_строки; *: значение)
Параметры
- ключ_таблицы
- Фрагмент текста документа, размещаемый в одной из строк таблицы; отмечает стартовую строку вставки данных (например, "_Товары"). Двоеточие или другой разделитель может добавляться для визуального отделения от ключевой строки столбца, но не является частью синтаксиса.
Табличная подстановка может выполняться не в строки, а в столбцы. Для этого ключ таблицы должен начинаться с символа ^. В виде строковой константы ключ может выглядеть так: "^Товары". В этом случае ключевые строки для подстановки данных должны располагаться в столбце, помеченном ключом таблицы. Подстановка по столбцам поддерживается только для электронных таблиц: Excel и Сalc. - ключ_столбца
- Фрагмент текста документа в стартовой строке таблицы, который задает места подстановки значений столбцов (например, "_наим" или "_цена").
- номер_строки
- Номер строки в табличной подстановке, нумерация от 1.
- значение
- Значение для подстановки, преобразуемое в текстовый вид (например, "не облагается", 20 или 12.07.2013). Если необходимо передать строковое значение, длина которого превышает 255 символов, следует использовать объект типа список. Строки списка "склеиваются" без разделительного символа, т.е. для списка "А","Б","В" результирующий текст будет "АБВ".
Передача данных в офисное приложение осуществляется функциями ЭКСПОРТ_ФОРМЫ, либо ЭКСПОРТ_ГРАФИКА.
Для добавления пустой табличной подстановки параметр номер_строки надо указать 0, а параметры ключ_столбца и значение роли не играют. Если табличная подстановка пустая (не содержит строк), то в документе удаляется строка, содержащая ключ таблицы.
Пример использования
Таблицы данных формируются с помощью последовательных вызовов функции ДОБ_ТАБЛ_ПОДСТ. Рассмотрим пример кода формирования таблицы данных.
ДОБ_ТАБЛ_ПОДСТ("Гр", "", 1, "Январь")
ДОБ_ТАБЛ_ПОДСТ("Гр", "Услуги", 1, 2.5)
ДОБ_ТАБЛ_ПОДСТ("Гр", "Материалы", 1, 2.1)
ДОБ_ТАБЛ_ПОДСТ("Гр", "Товары", 1, 4.2)
ДОБ_ТАБЛ_ПОДСТ("Гр", "Другое", 1, 3.3)
ДОБ_ТАБЛ_ПОДСТ("Гр", "", 2, "Февраль")
ДОБ_ТАБЛ_ПОДСТ("Гр", "Услуги", 2, 2.7)
ДОБ_ТАБЛ_ПОДСТ("Гр", "Материалы", 2, 2.4)
ДОБ_ТАБЛ_ПОДСТ("Гр", "Товары", 2, 3.8)
ДОБ_ТАБЛ_ПОДСТ("Гр", "Другое", 2, 2.9)
ДОБ_ТАБЛ_ПОДСТ("Гр", "", 3, "Март")
ДОБ_ТАБЛ_ПОДСТ("Гр", "Услуги", 3, 2.4)
ДОБ_ТАБЛ_ПОДСТ("Гр", "Материалы", 3, 2.2)
ДОБ_ТАБЛ_ПОДСТ("Гр", "Товары", 3, 4.1)
ДОБ_ТАБЛ_ПОДСТ("Гр", "Другое", 3, 3.5)
Здесь формируется таблица с 4-мя столбцами "Услуги", "Материалы", "Товары" и "Другое". Безымянный столбец определяет названия категорий. Здесь их задается 3: названия месяцев. В итоге получается следующая таблица данных:
В реальном коде таблицы данных формируются, как правило, в циклах.