Как обновить форму отчёта в 1С

Форма отчёта в 1С — это экран, который видит пользователь при открытии отчёта: поля периода, отборы, настройки СКД, кнопки «Сформировать». Обновить её приходится в нескольких ситуациях: после выхода новой версии типовой конфигурации, при замене внешнего отчёта на новую редакцию, после доработки формы в конфигураторе или при подключении расширения, которое меняет интерфейс отчёта. В каждом случае порядок действий свой, и путать их нельзя: обновление конфигурации и замена файла внешнего отчёта — разные процедуры с разными рисками.

Главное правило перед любыми изменениями — сделать резервную копию информационной базы. Ошибка при обновлении формы редко портит данные, но может привести к тому, что отчёт перестанет открываться у всех пользователей, а откат без копии займёт значительно больше времени, чем сама выгрузка. Для файловой базы достаточно скопировать каталог с файлом 1Cv8.1CD, для клиент-серверной — выполнить выгрузку через конфигуратор или средствами СУБД.

Определите, какой именно отчёт нужно обновить

Первый шаг — понять, к какому типу относится отчёт, потому что от этого зависит вся процедура. В типовых конфигурациях отчёты бывают встроенными (поставляются в составе конфигурации), внешними (подключаются файлом с расширением .erf через справочник «Дополнительные отчёты и обработки») и доработанными расширениями. Посмотреть тип можно в конфигураторе: если отчёт виден в дереве метаданных в ветке «Отчёты» — он встроенный, если его там нет, но он открывается в режиме предприятия — скорее всего, внешний или из расширения.

Быстрый практический признак: внешние отчёты обычно находятся в разделе «Администрирование — Печатные формы, отчёты и обработки — Дополнительные отчёты и обработки». Если отчёт есть в этом списке, обновляется он заменой файла, а не обновлением конфигурации. Встроенный отчёт обновляется только вместе с конфигурацией либо правкой в конфигураторе.

Обновление формы отчёта через обновление конфигурации

Если отчёт встроенный и типовой, его форма обновляется вместе с релизом конфигурации. Откройте конфигуратор, пройдите в меню «Конфигурация — Поддержка — Обновить конфигурацию» и выберите источник: поиск обновлений через интернет или файл обновления (.cfu), полученный с портала 1С. Мастер покажет сравнение объектов — в нём можно увидеть, затрагивает ли обновление нужный отчёт и его форму.

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

После завершения обновления обязательно выполните обновление конфигурации базы данных (клавиша F7 в конфигураторе) и запустите базу в режиме предприятия, чтобы отработали обработчики обновления. Без этого шага форма может открываться с ошибками, даже если само обновление прошло без предупреждений.

Обновление внешнего отчёта заменой файла

Внешний отчёт обновляется проще всего и без конфигуратора. Откройте в режиме предприятия раздел «Администрирование — Печатные формы, отчёты и обработки — Дополнительные отчёты и обработки», найдите нужный отчёт в списке и откройте его карточку. В карточке есть команда загрузки новой версии из файла — выберите актуальный файл .erf, полученный от разработчика или скачанный из проверенного источника.

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

1. 1
   Сохраните старый файл .erf отдельно — он пригодится для отката
2. 2
   Откройте карточку отчёта в списке дополнительных отчётов и обработок
3. 3
   Загрузите новый файл .erf командой замены
4. 4
   Проверьте версию и размещение отчёта в разделах
5. 5
   Сформируйте отчёт с тестовыми параметрами и сравните результат с ожидаемым

Правка формы отчёта в конфигураторе

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

Для отчётов на СКД часто форму вообще не нужно править: настройки выводятся автоматически, и достаточно изменить схему компоновки данных — добавить поле в набор данных или в настройки варианта. Прежде чем лезть в форму, проверьте, не решается ли задача через «Изменить вариант отчёта» в режиме предприятия — это безопаснее и не требует прав доступа к конфигуратору.

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

Обновление формы через расширение конфигурации

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

Обновление такой формы сводится к установке новой версии расширения: в режиме предприятия откройте список расширений («Администрирование — Печатные формы, отчёты и обработки — Расширения» в типовых конфигурациях), загрузите файл .cfe новой версии и перезапустите сеанс. Учтите ограничение: при обновлении основной конфигурации заимствованная форма может перестать соответствовать изменённому отчёту, и расширение придётся дорабатывать — это нормальная часть сопровождения.

Сравнение способов обновления формы

Обновление конфигурации

Подходит для типовых отчётов без доработок; при наличии изменений требует аккуратного объединения

Замена файла .erf

Самый простой способ для внешних отчётов; не требует конфигуратора, но зависит от корректности нового файла

Правка в конфигураторе

Полный контроль над формой; требует прав, снятия с поддержки и навыков разработки

Расширение

Сохраняет поддержку типовой конфигурации; требует проверки совместимости после каждого обновления релиза

Кэш и типичные проблемы после обновления

Частая ситуация: форму обновили, а пользователи видят старую версию или получают ошибку «Ошибка формата потока». Причина почти всегда в кэше метаданных на клиентских компьютерах. Для файловой базы помогает очистка кэша — удаление папок с идентификаторами базы в каталогах %APPDATA%\1C\1cv8 и %APPDATA%\1C\1cv82, либо удаление базы из списка и повторное добавление. Для серверной базы иногда требуется перезапуск службы агента сервера 1С.

Ещё одна типичная проблема — сохранённые пользовательские настройки отчёта. Если в новой версии формы изменились имена реквизитов или структура настроек СКД, старые сохранённые настройки могут вызывать ошибки при открытии. В этом случае настройки нужно сбросить: в форме отчёта выбрать стандартный вариант или очистить пользовательские настройки через «Все функции — Стандартные — Управление настройками».

Как проверить, что форма обновилась корректно

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

Дополнительно проверьте сохранение и загрузку настроек, работу кнопки «Сформировать» при пустых параметрах и поведение при недостатке прав. Если отчёт используется в регламентных заданиях (рассылка отчётов), убедитесь, что фоновое формирование тоже проходит без ошибок — форма в этом случае не участвует, но модуль отчёта должен отрабатывать корректно.

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

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

Открытие отчёта

Норма

Форма открывается без сообщений об ошибках

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

Ошибка формата потока или сообщение о несовпадении версий

Состав элементов формы

Норма

Новые поля и кнопки отображаются и доступны

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

Элементы отсутствуют или неактивны

Формирование

Норма

Отчёт строится, итоги совпадают с ожидаемыми

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

Ошибки выполнения, пустой результат при наличии данных

Сохранённые настройки

Норма

Варианты и настройки открываются и применяются

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

Ошибки при выборе старых сохранённых настроек

Частые вопросы

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

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

Почему после обновления пользователи видят старую форму?

Наиболее вероятная причина — клиентский кэш метаданных. Очистите кэш на компьютере пользователя, удалив соответствующие папки в каталоге %APPDATA%\1C, или удалите базу из списка и добавьте заново. Также проверьте, что обновление конфигурации базы данных действительно выполнено.

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

Используйте режим объединения с ручной разметкой: в окне сравнения снимите автообъединение с модуля формы и перенесите свои доработки в новую версию вручную. На перспективу такие изменения лучше выносить в расширение — тогда конфликты при обновлении практически исчезают.

Куда пропал отчёт после замены файла новой версией?

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

Опасно ли обновлять форму отчёта — можно ли испортить данные?

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

Как откатить обновление формы, если новая версия работает плохо?

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