Как получить список принтеров в 1С

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

Начиная с платформы 8.3.22 появился штатный метод ПолучитьИнформациюОПринтерах(), который закрывает большинство сценариев. Для более старых версий остаются обходные пути: WMI-запросы, PowerShell, чтение реестра или диалог выбора принтера. Ниже разобраны все варианты с примерами кода, их ограничения и типичные ошибки.

Важно сразу определить контекст: список принтеров клиентского компьютера и список принтеров сервера 1С — это разные наборы устройств. Если печать выполняется на сервере (например, фоновым заданием), методы, выполняемые на клиенте, не покажут нужные устройства, и наоборот.

Штатный метод ПолучитьИнформациюОПринтерах (платформа 8.3.22 и новее)

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

Пример вывода списка в окно сообщений:

ИнформацияОПринтерах = ПолучитьИнформациюОПринтерах();
Для Каждого Принтер Из ИнформацияОПринтерах Цикл
    Сообщить(Принтер.Имя + " | Драйвер: " + Принтер.ИмяДрайвера
        + " | По умолчанию: " + Принтер.ПринтерПоУмолчанию
        + " | Сетевой: " + Принтер.Сетевой);
КонецЦикла;

Если нужно получить только имена для списка выбора, массив легко преобразовать в СписокЗначений и показать пользователю через ПоказатьВыборИзМеню или заполнить элемент формы. Признак ПринтерПоУмолчанию удобен, чтобы предложить пользователю предустановленный вариант.

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

Получение списка принтеров через WMI

Для платформ старше 8.3.22 классический способ — запрос к WMI через COM-объект WbemScripting.SWbemLocator. Класс Win32_Printer содержит сведения обо всех принтерах, установленных в Windows: имя, порт, драйвер, сетевой ли принтер, устройство по умолчанию, состояние.

Локатор = Новый COMОбъект("WbemScripting.SWbemLocator");
Сервис = Локатор.ConnectServer(".", "root\cimv2");
Запрос = Сервис.ExecQuery("SELECT Name, PortName, DriverName, Network, Default FROM Win32_Printer");
Для Каждого Принтер Из Запрос Цикл
    Сообщить(Принтер.Name + " | " + Принтер.PortName + " | " + Принтер.DriverName);
КонецЦикла;

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

Полезное свойство Default класса Win32_Printer позволяет найти принтер по умолчанию: добавьте условие WHERE Default = TRUE в запрос. Свойство WorkOffline помогает отфильтровать устройства, помеченные как автономные, — печать на них зависнет в очереди.

Получение списка через PowerShell и командную строку

Альтернатива WMI — запуск внешней команды и разбор её вывода. Команда Get-Printer в PowerShell возвращает список принтеров, а wmic printer get name делает то же самое через устаревшую, но ещё встречающуюся утилиту WMIC. Из 1С команду запускают через ЗапуститьПриложение или КомандаСистемы, перенаправляя вывод во временный файл, который затем читается построчно.

powershell -NoProfile -Command "Get-Printer | Select-Object -ExpandProperty Name" > C:\Temp\printers.txt

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

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

Выбор принтера пользователем через диалог печати

Если цель — не получить список программно, а дать пользователю выбрать устройство, проще всего использовать штатный диалог печати. Метод Напечатать табличного документа с параметром РежимИспользованияДиалогаПечати.Использовать показывает стандартное окно, где пользователь сам выбирает принтер, число копий и диапазон страниц.

Для неинтерактивной печати на конкретное устройство используется свойство табличного документа ИмяПринтера: присвойте ему имя принтера (полученное любым из способов выше) и вызовите печать без диалога. Если имя указано с ошибкой или принтер недоступен, печать уйдёт на устройство по умолчанию или завершится ошибкой — поведение зависит от клиента и драйвера.

1. 1
   Получите список принтеров методом ПолучитьИнформациюОПринтерах() или через WMI
2. 2
   Покажите имена пользователю в списке выбора и сохраните выбранное значение
3. 3
   Перед печатью проверьте, что принтер с таким именем всё ещё доступен в текущем списке
4. 4
   Присвойте табличному документу свойство ИмяПринтера и вызовите Напечатать без диалога
5. 5
   Проверьте результат на тестовом документе, прежде чем включать режим для всех пользователей

Имена принтеров чувствительны к точному написанию, включая регистр и пробелы. Сетевой принтер, подключённый как \\SERVER\HP4050, и локально установленный тот же принтер — разные имена. Храните выбранное имя в настройках пользователя (например, через ХранилищеОбщихНастроек), чтобы не запрашивать выбор при каждой печати.

Клиент и сервер: где выполнять код

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

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

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

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

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

Ещё одна ловушка — виртуальные принтеры (Microsoft Print to PDF, XPS Writer, отправка в OneNote). Они присутствуют в списке наравне с физическими. Если пользователь выбирает устройство для печати этикеток, стоит фильтровать список или явно предупреждать о виртуальных устройствах.

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