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

Другое · 6 мин

Получение пользовательских настроек отчёта СКД в 1С программно

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

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

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

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

Когда программное получение настроек СКД оправдано

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

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

Что нужно знать перед чтением настроек

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

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

Порядок получения настроек пошагово

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

Порядок действий
  1. 1
    Определить объект отчёта и ключ настройки
  2. 2
    Учесть контекст текущего пользователя
  3. 3
    Получить коллекцию настроек по ключу
  4. 4
    Применить найденные параметры к отчёту
  5. 5
    Проверить результат и сохранить только при необходимости

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

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

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

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

Наличие настроек по ключу
Норма

Коллекция содержит ожидаемые параметры

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

Пустая коллекция или стандартные значения

Соответствие пользователю
Норма

Настройки принадлежат текущему сотруднику

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

Данные другого пользователя или отсутствие прав

Отображение в отчёте
Норма

Колонки и отборы совпадают с сохранёнными

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

Отчёт открывается с настройками по умолчанию

Проверка результата и признаки ошибок

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

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

Ограничения, права и риски

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

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

Сравнение вариантов

Программное получение настроек

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

Стандартный интерфейс пользователя

Проще для сотрудников, не подходит для автоматической подстановки отборов

Значения по умолчанию

Универсальны, но не отражают личные настройки пользователя

Альтернативы и сравнение вариантов

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

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

Типичные ошибки
01
Неверный ключ настройки приводит к пустому результату
02
Применение настроек после формирования отчёта не меняет вывод
03
Перезапись личных значений стандартными стирает отборы пользователя

Частые ошибки при работе с настройками СКД

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

Также часто забывают проверить результат перед сохранением и перезаписывают пользовательские настройки стандартными значениями. Это приводит к потере индивидуальных отборов и недовольству сотрудников.

Итог

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

Настройки СКД привязаны к пользователю и ключу отчёта; перед использованием проверяйте наличие, права и соответствие текущему сеансу.

Часто задаваемые вопросы

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

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

Что делать, если настройки не находятся по ключу?

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

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

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

Нужно ли сохранять настройки после каждого программного чтения?

Нет. Чтение само по себе не изменяет данные. Сохранение требуется только тогда, когда вы вносите намеренные изменения в параметры отчёта и хотите закрепить их в профиле пользователя.