1. Идентификация
| Параметр | Значение |
|---|---|
| Полное имя | Справочник.ВариантыОтчетов |
| Имя объекта | ВариантыОтчетов |
| Синоним | «Варианты отчетов» |
| Конфигурация | «Бухгалтерия для Казахстана», редакция 3.0, версия 3.0.74.2 |
| Подсистема | Стандартные подсистемы (БСП) → «Варианты отчетов» |
| Назначение | Центральное хранилище сохраненных настроек отчетов: предопределенных, встроенных в конфигурацию, и пользовательских. Объект используется для размещения вариантов в панелях разделов, разграничения доступа по авторам и хранения многоязычных описаний. |
Где найти в 1С: доступ к вариантам выполняется из форм отчетов и предусмотренных конфигурацией команд администрирования отчетов. Навигационная ссылка для списка: e1cib/list/Справочник.ВариантыОтчетов.
Кто и когда использует: бухгалтеры и аналитики работают с объектом при сохранении настроек отчета командой «Сохранить как…», выборе сохраненного варианта и настройке его отображения в разделах интерфейса. Администраторы используют его при управлении общими вариантами и их доступностью для сотрудников.
Примечание о типе объекта. В релизе 3.0.74.2 «ВариантыОтчетов» рассматривается как служебный справочник подсистемы вариантов отчетов. Он хранит настройки и описание представления отчетов, поэтому при программном обращении используется ссылка типа СправочникСсылка.ВариантыОтчетов.
2. Реквизиты и табличные части
2.1 Реквизиты шапки
| Имя | Тип | Обязательность | Назначение |
|---|---|---|---|
| Автор | СправочникСсылка.ВнешниеПользователи, СправочникСсылка.Пользователи | Выдавать ошибку | Пользователь, создавший вариант. Реквизит определяет владельца настроек и используется при разграничении доступа к пользовательским вариантам. |
| ВидимостьПоУмолчанию | Булево | Не проверять | Определяет, должен ли вариант по умолчанию отображаться в панелях отчетов для пользователей. |
| ВидимостьПоУмолчаниюПереопределена | Булево | Не проверять | Показывает, что установленное администратором значение видимости отличается от исходной настройки варианта. |
| ИнтерактивнаяПометкаУдаления | Булево | Не проверять | Служебный признак интерактивной пометки: такой вариант можно исключить из рабочих списков, сохранив его данные в информационной базе до выполнения предусмотренной процедуры удаления. |
| КлючВарианта | Строка | Не проверять | Идентификатор варианта в рамках отчета. Используется для программного сопоставления и обновления предопределенных вариантов. |
| КлючевыеСлова | Строка | Не проверять | Содержит ключевые слова, по которым вариант можно найти в интерфейсе отчетов. |
| Контекст | Строка | Не проверять | Хранит контекст вызова отчета, например открытие отчета из формы прикладного объекта. Для контекстного варианта размещение в общих разделах не используется. |
| НаименованияПараметровИОтборов | Строка | Не проверять | Текстовое представление параметров и отборов варианта, используемое для индексации и поиска. |
| НаименованияПолей | Строка | Не проверять | Текстовое представление выбранных полей отчета, используемое для индексации и поиска. |
| Настройки | ХранилищеЗначения | Не проверять | Содержит набор настроек отчета: параметры, отборы, выбранные поля, сортировку и условное оформление. Это основной реквизит сохраненного варианта. |
| Описание | Строка | Не проверять | Подробное описание варианта, которое может выводиться пользователю при выборе отчета. |
| ОписаниеЯзык1 | Строка | Не проверять | Описание на первом дополнительном языке, предусмотренном настройками локализации информационной базы. |
| ОписаниеЯзык2 | Строка | Не проверять | Описание на втором дополнительном языке для конфигурации с несколькими языками интерфейса. |
К объекту также относятся реквизиты, связывающие вариант с отчетом и его владельцем: Отчет, ТипОтчета, Пользователь и Предопределенный. Стандартные реквизиты справочника включают Наименование и ПометкаУдаления. Конкретный набор доступных полей просматривается в форме элемента, форме списка или через метаданные конфигурации релиза 3.0.74.2.
2.2 Табличные части
| Табличная часть | Ключевые колонки | Назначение |
|---|---|---|
| Размещение | Подсистема, важность или режим видимости | Определяет разделы интерфейса, в которых показывается вариант отчета, а также его положение в панели отчетов. Для варианта с заполненным контекстом общее размещение по разделам не задается. |
| КлючевыеСловаПоиска | Строка поиска, язык представления | Содержит дополнительные поисковые фразы, в том числе представления на языках интерфейса, для быстрого поиска варианта. |
3. Формы
| Форма | Назначение |
|---|---|
| Форма элемента | Просмотр и редактирование одного варианта: наименования, описания, автора, видимости и размещения по разделам. |
| Форма списка | Просмотр вариантов отчетов, административное управление видимостью и установка пометки удаления. |
| Форма выбора | Выбор варианта при обращении из панели отчетов или другого элемента интерфейса. |
| Форма выбора варианта | Интерактивный выбор сохраненной настройки пользователем в списке вариантов конкретного отчета. |
| Форма размещения в разделах | Настройка разделов интерфейса, в которых отображается вариант, и его значимости для пользователя. |
Состав команд и представление форм определяются включенной в релиз 3.0.74.2 версией подсистемы вариантов отчетов. Пользователь работает с этими формами через команды отчета и панели разделов; непосредственное открытие служебного списка обычно используется администратором.
4. Ключевые процедуры модулей
Программная логика объекта сосредоточена на сохранении варианта, заполнении владельца, обработке размещения и подготовке данных для поиска. Точные имена экспортных процедур следует брать из модулей конфигурации релиза 3.0.74.2, поскольку интерфейс общих модулей БСП меняется вместе с версией библиотеки.
Основные операции модуля объекта:
- Обработка перед записью — согласование реквизитов варианта, его контекста и размещения.
- Обработка записи — сохранение служебных данных, необходимых для поиска и отображения варианта.
- Обработка заполнения — заполнение автора или владельца при создании пользовательского варианта.
- Обработка копирования — подготовка самостоятельного пользовательского варианта на основе существующей настройки.
Общие модули подсистемы «Варианты отчетов»:
- читают и записывают значение реквизита Настройки;
- преобразуют настройки компоновки данных в строки, используемые при поиске;
- управляют видимостью и размещением вариантов в разделах интерфейса;
- сопоставляют предопределенные варианты конфигурации с ранее сохраненными данными информационной базы;
- обеспечивают получение списка вариантов, доступных текущему пользователю.
При доработке расширения безопаснее обращаться к опубликованным процедурам общих модулей подсистемы. Прямая запись служебных полей может привести к расхождению между настройками, поисковым представлением и видимостью варианта.
5. Проведение и движения
«ВариантыОтчетов» — служебный справочник подсистемы отчетности. Его записи описывают сохраненные представления отчетов и используются при построении пользовательского интерфейса.
При сохранении варианта изменяются его собственные данные и связанные с ним служебные настройки:
- в реквизите Настройки сохраняются параметры выбранного представления отчета;
- служебные строки поиска приводятся в соответствие с составом полей, параметров и отборов;
- размещение определяет доступность варианта в панелях соответствующих разделов;
- персональные параметры видимости учитываются подсистемой при формировании списка для конкретного пользователя.
Содержание показателей, выводимых в отчете, определяется учетными данными информационной базы и логикой самого отчета. Справочник хранит способ представления этих данных: состав полей, отборы, группировки, сортировку и оформление.
6. Связанные объекты и ввод на основании
- Отчеты конфигурации — каждый вариант относится к конкретному отчету; ключ варианта используется для сопоставления предопределенной настройки этого отчета.
- Справочник «Пользователи» и список внешних пользователей — используются для хранения автора, владельца и разграничения доступа.
- Идентификаторы объектов метаданных — позволяют связать запись с объектом отчета в конфигурации.
- Служебные данные персональных настроек — используются подсистемой для индивидуального отображения вариантов.
- Подсистемы и разделы командного интерфейса — выбираются при настройке размещения варианта.
Ввод на основании: для справочника не используется. Пользовательский вариант создается из формы отчета командой сохранения текущих настроек либо средствами подсистемы вариантов отчетов. Предопределенные варианты поставляются в составе конфигурации и сопоставляются с записями информационной базы по отчету и ключу варианта.
7. Точки расширения
- Расширение конфигурации: добавление собственных реквизитов и обработчиков при сохранении объекта с учетом стандартной логики подсистемы.
- Дополнительные варианты отчетов: программное описание предопределенных вариантов и их настроек в модуле соответствующего отчета.
- Многоязычность: заполнение основного и дополнительных описаний для используемых языков интерфейса.
- Управление видимостью и размещением: использование программного интерфейса подсистемы вместо прямого изменения служебных данных.
- Разграничение доступа: учет автора и владельца при добавлении собственных сценариев доступа к пользовательским вариантам.
- Поиск: дополнение ключевых слов и описаний с сохранением согласованности поисковых полей.
При расширении объекта необходимо учитывать обновление типовой конфигурации. Изменения, выполненные через расширение и предусмотренные программные интерфейсы, проще сопровождать при переходе на следующий релиз, чем прямые изменения стандартных модулей.
8. Вопросы и ответы
Как сохранить отдельный вариант отчета?
Откройте нужный отчет, установите параметры, отборы, группировки и состав полей, затем выполните команду сохранения варианта. Для нового варианта задайте понятное наименование, по которому бухгалтер сможет отличить его от стандартных и ранее сохраненных настроек.
Почему сохраненный вариант не отображается в панели раздела?
Отображение зависит от размещения варианта, установленной видимости и прав текущего пользователя. Для контекстного варианта вызов выполняется из связанного элемента интерфейса, поэтому он не включается в общую панель раздела. Администратор может проверить размещение и доступность варианта в настройках отчетов.
Чем пользовательский вариант отличается от предопределенного?
Предопределенный вариант входит в состав конфигурации и идентифицируется ключом, заданным разработчиком. Пользовательский вариант создается в информационной базе из текущих настроек отчета и принадлежит пользователю либо предоставляется другим сотрудникам в соответствии с настройками доступа.
Что сохраняется в реквизите «Настройки»?
В нем хранится представление отчета, выбранное пользователем: параметры, отборы, поля, группировки, сортировка и условное оформление. Набор сохраняемых элементов зависит от схемы компоновки конкретного отчета и доступных в его форме команд.
Что учитывать перед обновлением конфигурации?
Предопределенные варианты могут обновляться вместе с конфигурацией, а пользовательские настройки остаются данными информационной базы. Перед обновлением полезно зафиксировать перечень важных общих вариантов и после перехода на новый релиз проверить их открытие, размещение, отборы и состав выводимых полей.