Как программно получить основную организацию в 1С

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

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

Где хранится основная организация в разных конфигурациях

Первый шаг — определить, каким механизмом пользуется ваша конфигурация. В современных типовых решениях (БП 3.0, УТ 11, ERP, ЗУП 3.1), построенных на БСП, основная организация хранится в персональных настройках пользователя, а доступ к ней инкапсулирован в программный интерфейс подсистемы «Организации». Прямого обращения к настройкам в коде писать не нужно — для этого есть готовые функции.

В конфигурациях предыдущего поколения (УПП 1.3, КА 1.1, УТ 10.3) применялась константа «ОсновнаяОрганизация». Она одна на всю информационную базу и не зависит от пользователя. В самописных конфигурациях встречаются оба варианта, а также собственные регистры сведений.

Получение организации по умолчанию в конфигурациях на БСП

В конфигурациях на базе БСП основной способ — вызов метода менеджера справочника организаций. Код выглядит так:

ОсновнаяОрганизация = Справочники.Организации.ОрганизацияПоУмолчанию(Пользователь);

Параметр «Пользователь» необязателен. Если его не передать, будет использован текущий пользователь сеанса. Функция возвращает ссылку на элемент справочника «Организации». Если пользователю доступна только одна организация, возвращается она; если настройка не задана и организаций несколько, результат может быть пустой ссылкой.

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

ОсновнаяОрганизация = Организации.ОрганизацияПоУмолчанию(Пользователь);

Точное имя модуля и сигнатуру стоит уточнить в коде вашей версии конфигурации: откройте модуль менеджера справочника «Организации» и найдите экспортную функцию «ОрганизацияПоУмолчанию» — её описание в комментарии содержит актуальные параметры.

ОсновнаяОрганизация = Справочники.Организации.ОрганизацияПоУмолчанию();
Если НЕ ЗначениеЗаполнено(ОсновнаяОрганизация) Тогда
    ВызватьИсключение "Для пользователя не задана основная организация";
КонецЕсли;

Получение через константу в старых конфигурациях

В УПП 1.3, КА 1.1 и УТ 10.3 основная организация хранится в константе. Получение значения — одна строка:

ОсновнаяОрганизация = Константы.ОсновнаяОрганизация.Получить();

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

ОсновнаяОрганизация = УправлениеПользователями.ПолучитьЗначениеПоУмолчанию(
ТекущийПользователь, "ОсновнаяОрганизация");

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

Получение через персональные настройки БСП напрямую

Если по какой-то причине нужно обратиться к настройке напрямую (например, для её записи или пакетной установки пользователям), в БСП используется модуль «ПерсональныеНастройки» или общий механизм хранения настроек. Однако прямое чтение настроек в обход программного интерфейса — хрупкое решение: структура хранения может измениться при обновлении библиотеки.

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

Особенности работы в фоновых заданиях и веб-сервисах

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

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

ПараметрыЗадания = Новый Массив;
ПараметрыЗадания.Добавить(Справочники.Организации.ОрганизацияПоУмолчанию());
ФоновыеЗадания.Выполнить("МойМодуль.ОбработатьДанные", ПараметрыЗадания);

Если задание должно работать с конкретной организацией независимо от пользователя, храните её в параметрах самого регламентного задания или в специально созданной константе/настройке, а не полагайтесь на пользовательский контекст.

Проверка результата и защита кода

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

Минимальный шаблон защищённого кода:

ОсновнаяОрганизация = Справочники.Организации.ОрганизацияПоУмолчанию();
Если НЕ ЗначениеЗаполнено(ОсновнаяОрганизация) Тогда
// Запасной вариант: единственная организация в базе
Запрос = Новый Запрос("ВЫБРАТЬ ПЕРВЫЕ 2 Ссылка ИЗ Справочник.Организации ГДЕ НЕ ПометкаУдаления");
Выборка = Запрос.Выполнить().Выбрать();
Если Выборка.Количество() = 1 Тогда
Выборка.Следующий();
ОсновнаяОрганизация = Выборка.Ссылка;
КонецЕсли;
КонецЕсли;
Если НЕ ЗначениеЗаполнено(ОсновнаяОрганизация) Тогда
ВызватьИсключение "Не удалось определить основную организацию";
КонецЕсли;

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

Сравнение способов получения основной организации

Выбор способа зависит от конфигурации и контекста выполнения. Сводная таблица помогает быстро сориентироваться:

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