Как получить код пользователя в 1С

Под «кодом пользователя» в 1С обычно понимают одно из трёх: код элемента справочника «Пользователи», уникальный идентификатор (GUID) пользователя информационной базы или имя пользователя, под которым выполнен вход. Это разные сущности, и путать их — частая причина ошибок в доработках, обменах и настройках прав.

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

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

Что именно считается «кодом пользователя» в 1С

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

• Код справочника — числовой или строковой код элемента справочника «Пользователи». Используется для поиска, нумерации и в простых обменах.
• GUID (уникальный идентификатор ссылки) — 36-символьный идентификатор объекта базы. Нужен для обменов между базами и внешних интеграций.
• Уникальный идентификатор пользователя ИБ — GUID записи в списке пользователей информационной базы. Связывает справочник с учётной записью входа.
• Имя пользователя — логин, под которым выполняется вход (например, «ИвановИИ»). Это не код, но часто его тоже называют кодом пользователя.

Как посмотреть код пользователя в режиме 1С:Предприятие

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

Код конкретного пользователя виден и в его карточке — обычно в заголовке формы рядом с наименованием. Если код не виден совсем, проверьте настройку нумерации справочника: в некоторых конфигурациях реквизит «Код» скрыт прикладным кодом, хотя физически заполняется.

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

1. 1
   Откройте «Администрирование» → «Пользователи и права» → «Пользователи»
2. 2
   Если колонки «Код» нет — включите её через «Ещё» → «Изменить форму»
3. 3
   Откройте карточку нужного пользователя и найдите код в заголовке формы
4. 4
   Для просмотра логина перейдите по ссылке настроек входа в карточке

Как получить код пользователя программно во встроенном языке

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

Текущий пользователь сеанса

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

ТекущийПользователь = Пользователи.ТекущийПользователь();
КодПользователя = ТекущийПользователь.Код;

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

Имя и идентификатор пользователя информационной базы

Если нужны данные учётной записи входа, а не справочника, используйте менеджер пользователей ИБ:

ПользовательИБ = ПользователиИнформационнойБазы.ТекущийПользователь();
ИмяПользователя = ПользовательИБ.Имя; // логин
Идентификатор = ПользовательИБ.УникальныйИдентификатор; // GUID записи ИБ

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

Код по известному имени пользователя

Когда известен логин, элемент справочника ищут через идентификатор пользователя ИБ:

ПользовательИБ = ПользователиИнформационнойБазы.НайтиПоИмени("ИвановИИ");
Если ПользовательИБ <> Неопределено Тогда
СсылкаПользователь = Справочники.Пользователи.НайтиПоРеквизиту(
"ИдентификаторПользователяИБ",
ПользовательИБ.УникальныйИдентификатор);
Если Не СсылкаПользователь.Пустая() Тогда
КодПользователя = СсылкаПользователь.Код;
КонецЕсли;
КонецЕсли;

Как получить коды всех пользователей запросом

Для отчётов и выгрузок удобнее получить список кодов одним запросом, а не перебором:

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

Фильтр по пометке удаления исключает неактуальные записи. Если нужен GUID ссылки для обмена, добавьте в запрос вычисление через УникальныйИдентификатор() уже на стороне кода — в языке запросов прямого представления GUID нет, его получают методом Ссылка.УникальныйИдентификатор() при обходе выборки.

Для разового просмотра без программирования подойдёт консоль запросов (внешняя обработка) или универсальный отчёт по справочнику «Пользователи» с выводом реквизита «Код».

Сообщить(Пользователи.ТекущийПользователь().Код);

Как получить GUID пользователя для обмена и интеграций

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

GUID = XMLСтрока(ТекущийПользователь.УникальныйИдентификатор());

Обратное преобразование строки в ссылку выполняется так:

НовыйGUID = Новый УникальныйИдентификатор(СтрокаGUID);
СсылкаПользователь = Справочники.Пользователи.ПолучитьСсылку(НовыйGUID);
Если СсылкаПользователь.ПолучитьОбъект() = Неопределено Тогда
// объекта с таким GUID в базе нет
КонецЕсли;

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

Типичные ошибки и ограничения

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

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

Третья ошибка — поиск по наименованию вместо кода или GUID. Наименования («Иванов Иван Иванович») не уникальны и редактируются пользователями с правами, поэтому поиск по ним ненадёжен.

Ограничение прав: без роли «Добавление изменение пользователей» или полных прав часть данных (настройки входа, идентификаторы ИБ) будет недоступна даже на чтение в отдельных конфигурациях.

Как проверить, что получен правильный код

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

Для GUID дополнительно проверьте обратное преобразование: строка должна успешно превращаться в ссылку, а ссылка — находить существующий объект, а не «битую» ссылку. Признак битой ссылки — текст вида «Объект не найден» в представлении.

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