К статье
Практический материал

Другое · 7 мин

Как получить имя параметра табличного документа 1С

Практически объясняем, как получить имя параметра табличного документа в 1С: через коллекцию Параметры, перебор элементов и проверку в отладчике, без лишней теории.

Табличный документ в 1С часто используется для формирования печатных форм, отчётов и выгрузок. В его макете могут встречаться параметры, значения которых подставляются программно перед выводом. Иногда разработчику нужно не только значение, но и само имя параметра, чтобы динамически составить запрос, проверить шаблон или сгенерировать документ.

Получение имени параметра не является отдельной универсальной командой: всё зависит от того, где параметр объявлен, как заполняется табличный документ и какая конфигурация используется. Ниже рассмотрены приёмные способы, условия их применения и признаки корректного результата.

Что представляет собой параметр табличного документа

Параметр табличного документа — это именованное значение, которое может быть подставлено в макет при выводе. В макете параметр обычно обозначается специальным маркером, а в коде ему присваивается значение перед печатью или сохранением. Имя параметра нужно, когда программа должна сама определить, какие поля ожидает шаблон.

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

Где и как параметры задаются

Программное задание параметров

В коде параметр может задаваться через объект табличного документа перед выводом макета. Например, значение присваивается по имени, после чего движок подставляет его в соответствующее место печатной формы. При таком подходе имя уже известно разработчику, но может потребоваться получить его автоматически при анализе чужого шаблона.

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

Параметры в макете и отчётах

В макете табличного документа параметры могут быть указаны явно или использоваться в условном оформлении. При открытии макета в конструкторе можно увидеть список параметров, но программный доступ к этому списку требует обращения к объектной модели табличного документа, а не к тексту макета.

При работе с внешними отчётами и обработками параметры могут передаваться через форму или через набор параметров отчёта. Здесь полезно различать параметры самого отчёта и параметры табличного документа, который отчёт формирует.

Как получить имя параметра табличного документа

Наиболее распространённый способ — перебор коллекции Параметры объекта ТабличныйДокумент. Каждый элемент коллекции обычно представляет параметр и имеет свойство, содержащее его имя. После обхода коллекции можно составить список имён или найти параметр по заданному условию.

Для Каждого Параметр Из ТабличныйДокумент.Параметры Цикл
Имя = Параметр.Имя;
// дальнейшая обработка имени
КонецЦикла;

Приведённый фрагмент иллюстрирует общий подход, а не гарантирует точное имя свойства в каждой конфигурации. Перед использованием в продакшене проверьте доступные свойства и методы в синтакс-помощнике или в отладчике своей платформы.

Поиск по известному имени

Если имя параметра заранее известно, можно попытаться обратиться к параметру напрямую. Успех такого обращения подтверждает, что параметр с этим именем присутствует в текущем табличном документе. Если обращение завершается ошибкой, имя либо отсутствует, либо написано с учётом регистра и особенностей конфигурации.

Регистрозависимость и допустимые символы в именах параметров определяются конфигурацией и версией платформы. Не полагайтесь на неявное приведение регистра без проверки в конкретной информационной базе.

Порядок действий
  1. 1
    Откройте табличный документ и убедитесь, что макет загружен
  2. 2
    Обратитесь к коллекции Параметры объекта табличного документа
  3. 3
    Переберите элементы коллекции и получите имя каждого параметра
  4. 4
    Сравните полученные имена с маркерами в макете
  5. 5
    Проверьте результат в отладчике на копии базы

Проверка результата и границы применения

Результат считается корректным, если перебор коллекции возвращает ожидаемые имена, а обращение к параметру по имени не вызывает ошибку. Полезно вывести полученные имена в сообщение или регистрацию и сравнить их с маркерами в макете.

Если коллекция параметров пуста, это может означать, что макет не загружен, параметры не заданы или табличный документ ещё не подготовлен к выводу. Пустая коллекция сама по себе не является ошибкой, но показывает, что искать имена пока негде.

Не вносите изменения в рабочую базу без резервной копии, если экспериментируете с заполнением табличных документов. Ошибка в коде вывода может испортить печатную форму или привести к некорректному документу, который потом придётся исправлять вручную.

Частые ошибки и ограничения

Одна из частых ошибок — попытка получить имя параметра из пустого или ещё не заполненного табличного документа. В такой ситуации коллекция может быть пустой, и код вернёт пустой список, что легко принять за отсутствие параметров вообще.

Типичные ошибки
01
Перебор коллекции параметров в пустом табличном документе и вывод пустого списка
02
Путаница между параметрами макета и полями источника данных

Другая ошибка — путаница между параметрами табличного документа и полями запроса, набора данных или формы. Имена полей источника не всегда совпадают с именами параметров макета, поэтому прямое копирование имён из запроса может не сработать.

Также не стоит предполагать, что имена параметров одинаковы во всех конфигурациях и отчётах. Каждый шаблон может использовать свой набор, и автоматический перенос кода из одной конфигурации в другую требует повторной проверки.

Контрольные точки

Как проверить результат

Коллекция параметров не пуста после загрузки макета
Норма

Возвращается список имён параметров

Тревожный признак

Коллекция пуста или обращение к параметру вызывает ошибку

Имя параметра совпадает с маркером в макете
Норма

Подстановка значения работает корректно

Тревожный признак

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

Альтернативы и когда искать имена не нужно

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

В некоторых случаях удобнее просмотреть макет в конструкторе или экспортировать его представление, чтобы вручную составить список параметров. Это медленнее, но надёжнее для разовых задач и сложных шаблонов.

Итог

Что важно запомнить

Имена параметров табличного документа получают через объектную модель табличного документа, обычно коллекцию Параметры, с обязательной проверкой в конкретной конфигурации и на копии базы.

Нужно ли получать имена параметров для каждой печатной формы?

Не обязательно. Если имена параметров известны и не меняются, проще использовать их напрямую. Динамический поиск имеет смысл для универсальных обработок, анализа чужих макетов или генерации документации.

Что делать, если коллекция параметров пуста?

Проверьте, загружен ли макет и заданы ли параметры перед обращением к коллекции. Пустая коллекция может означать отсутствие параметров или то, что табличный документ ещё не подготовлен к выводу.

Можно ли использовать имена полей запроса вместо имён параметров табличного документа?

Не всегда. Имена полей источника данных и имена параметров макета могут не совпадать. Перед подстановкой значения убедитесь, что параметр с таким именем существует в табличном документе.

Безопасно ли изменять код заполнения табличных документов в рабочей базе?

Лучше проверять изменения на копии информационной базы. Ошибка в выводе может привести к некорректным печатным формам и потребует дополнительной корректировки документов.

Где уточнить точные имена свойств для доступа к параметрам?

Используйте синтакс-помощник и отладчик своей конфигурации. Точный набор свойств коллекции параметров может зависеть от версии платформы и особенностей прикладного решения.